Match Events

What are Match Events?

Automated graphics are generated from match events. With match events you can manage the clock, show pre-game lineup, and display goals, assists, penalties etc.

CLOCK

The match clock is controlled by clock info which have has four eventTypes.

START : The match clock will start counting from the given minutes and seconds.
STOP : Will stop the clock at the given minutes and seconds.
RESET: Reset the clock, use this for the pause
END: At the end of the game

CODE

POST https://api.livearenasports.com/match-event/clock-info
Content-Type: application/json
site-id: BACKOFFICE
Authorization: Bearer <your token>
{  
"broadcastExtId": <your match id>,  
"siteId": "<your site id>",  
"eventType": "START",  
"minutes": 17,  
"seconds": 56,  
"timeAscending": false,  
"timeInSecs": 2276,  
"timeStamp": "2022-08-05T19:49:45.3208851+02:00"
}

Match Events
Supported types of match-events are:

GOAL
PENALTY
SUBSTITUTION
SHOT

CODE

POST https://api.livearenasports.com/match-event/v2
Content-Type: application/json
site-id: BACKOFFICE
Authorization: Bearer <your token>
{  
  "broadcastExtId": <your match id>,  
  "siteId": "<your site id>",  
  "eventType": "GOAL",  
  "minutes": 17,  
  "period": 2,  
  "seconds": 56,  
  "timeAscending": false,  
  "timeInSecs": 2276,  
  "timeStamp": "2022-08-05T19:49:45.3208851+02:00",
  "actionPlayer": {
    "extId": "<your player id>",
    "firstName": "<player first name>",
    "lastName": "<player last name>",
    "num": 10
  },
  "assistingPlayers": [{
    "extId": "<your player id>",
    "firstName": "<player first name>",
    "lastName": "<player last name>",
    "num": 12
  }],
  "teamType": "AWAY",
  "homeGoals": 0,
  "awayGoals": 1
}

Example of a goal

CODE

POST https://api.test.livearenasports.com/match-event/v2
Content-Type: application/json
site-id: BACKOFFICE
Authorization: Bearer ey…..
{
  "broadcastExtId": “123456",  
  "actionPlayer": {
    "extId": "1234",
    "firstName": "Magnus",
    "lastName": "Testsson",
    "num": 10
  },
  "assistingPlayers": [],
  "siteId": “SAMPLE_SITE",  
  "homeGoals": 2,
  "awayGoals": 0,
  "minutes": 0,
  "seconds": 0,
  "period": 1,
  "eventType": "GOAL",
  "teamType": “HOME”
}

Example of a penalty

CODE

POST https://api.test.livearenasports.com/match-event/v2
Content-Type: application/json
site-id: BACKOFFICE
Authorization: Bearer ey.....

{
  "broadcastExtId": "12345",
  "actionPlayer": {
    "extId": "1234",
    "firstName": "Magnus",
    "lastName": "Testsson",
    "num": 10
  },
  "durationInSecs": 120,
  "name":"Slashing",
  "siteId": "SAMPLE_SITE",
  "minutes": 10,
  "seconds": 5,
  "period": 1,
  "eventType": "PENALTY",
  "teamType": "HOME"

}

Match standing
Match standings are used for signaling different game statuses, which in turn controls graphics in different ways. Useful types of statuses are:

NOT_STARTED : Pre-game graphics are allowed in this state
RUNNING : Game is running, pre-game or intermission graphics will be removed
PAUSED : Intermission graphics are allowed.
ENDED : Is used to end the broadcast.

Match standing is also used to update current period and can also be used to update current score in the broadcast. Example request below:

CODE

POST https://api.livearenasports.com/match-event/standing
Content-Type: application/json
site-id: BACKOFFICE
Authorization: Bearer <your token>
{  
  "broadcastExtId": <your match id>,  
  "siteId": "<your site id>",  
  "period": 2,  
  "homeGoals": 0,
  "awayGoals": 1,
  "status": "RUNNING"
}

Requirements

siteId AND broadcastExtId OR broadcastIdare required on all types.

Lineup and officials should be sent as soon as the broadcast is live to present them pregame.

How do I create them?

There are multiple different types of match events, and information on how to create them can be found in the detailed API documentation.

Detailed API documentation

Download OpenAPI Schema