Broadcasts / Games

Scheduling

Scheduling broadcasts is easy. All you need is to supply when it will be broadcasted (start), which teams are participating (homeTeam & awayTeam or teams), which competition it is played in, and where it is played (venueId).

Supplying the teams can be done in two different ways, explained below.

Two-Team Game

When there are only two teams participating, you need to supply a homeTeam and an awayTeam, and a unique id, extId, so you can keep track of the broadcast.

Group
externalId = club id (example Arsenal, Milan)
teamExtId = team id
teamName = team specific name (example Team A, Blue)

CODE

POST https://api.livearenasports.com/broadcast/ext
Content-Type: application/json
site-id: BACKOFFICE
Authorization: Bearer <YOUR-TOKEN-HERE>

{
  "siteId": "SAMPLE_SITE",
  "venueExtId": "311",
  "start": "2024-03-06T20:22:00.000Z",
  "extId": "<GAME-ID>",
  "homeTeam": {
    "extId": "194",
    "teamName" : "Blue"
  },
  "awayTeam": {
    "extId": "194",
    "teamName" : "Red"
  },
  "competition": {
    "extId": "5773"
  }
}

Pool Games

When there are more than two teams participating, you need to supply all the participating teams. You also need to supply a list of unique ids, extIds, one for each of the games played simultaneously.

Locked Changes

Broadcasts can be locked from changes, and if you try to update a locked broadcast you will receive a HTTP Response of 400 - Bad Request.

CURL examples

Here is a simplified request where you only need to supply your external ids and the system enriches with the internal entities for you:

TEXT

curl --location --request POST 'https://api.livearenasports.com/broadcast/ext' \
--header 'site-id: BACKOFFICE' \
--header 'Authorization: Bearer <YOUR-TOKEN-HERE>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "siteId": "SIF",
    "venueExtId": "3448466",
    "start": "2022-06-29T12:06:00.000Z",
    "extId": "1938465",
    "competition": {
        "extId": "2758855"
    },
    "homeTeam": {
        "extId": "2119858"
    },
    "awayTeam": {
        "extId": "1752115"
    }
}'

Optionally you can also use this endpoint where you need to supply the internal ids along with the entire entities:

TEXT

curl --location --request POST 'https://api.livearenasports.com/broadcast' \
--header 'site-id: BACKOFFICE' \
--header 'Authorization: Bearer <YOUR-TOKEN-HERE>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "siteId": "SIF",
    "venueId": "61152e5cb3d972437ac6f73e",
    "start": "2022-06-29T12:06:00.000Z",
    "extId": "1938465"
    "competition": {
        ...
    },
    "homeTeam": {
        ...
    },
    "awayTeam": {
        ...
    }
}'

Detailed API Documentation

Download OpenAPI Schema