1 of 28

Basketball - Media

Basketball on the DDE

Welcome to the documentation section for IMG Arena's Basketball Data Feeds. In this section, we will cover off all our consumer facing APIs and Websockets, which allow our clients to connect to the best in class Data Feeds.

Below is a summary of our current offering. For more detail on each feed, please use the left hand navigation section for more detail. Each section will overview that API/Websocket, Endpoint URLs, Request Parameters, Response Models and sample files.

For any further issues or information please reach out to our Support team.

Polling limits

IMG Arena monitor the incoming traffic from our customers and strive to ensure that traffic is controlled, in-keeping with our guidelines and not unnecessarily excessive. We would suggest a polling rate of 5 requests per second, whilst we strive towards implementing rate limiting.

APIs

API

URL

Description

Seasons API

/basketball/seasons

Lists the seasons between a start/end date and is useful for obtaining competition id's, season id's, stage id's

Live Fixtures (Subscribed)

/basketball/fixtures?live=true&subscribed=true

/basketball/seasons/{seasonId}/fixtures?live=true&subscribed=true

Live fixtures for which a client is licensed. This allows clients to determine which fixtures are live and available.

Fixtures (Subscribed)

/basketball/fixtures?subscribed=true

/basketball/seasons/{seasonId}/fixtures?subscribed=true

The fixtures for a competition for which a client is licensed.

All Fixtures (Unsubscribed)

/basketball/fixtures

OR /basketball/seasons/{seasonId}/fixtures

Lists ALL the fixtures for all competitions. This is useful to determine what IMGA covers for that sport.

Squads

/basketball/seasons/{seasonId}/squads

Lists all the players registered to a squad within a given competition.

Websockets

WS Feed

URL

Description

Live Actions

/basketball/fixtures/{fixture-id}/actions

Contains a live 'stream' of the team and player actions happening within the football match - this will include; goals, cards, shots and more.

Match Statistics

/basketball/fixtures/{fixture-id}/statistics

This will display the aggregated player and team match actions which produce statistics like goals, cards, shots, number of attacks and more.

Schedule API

The FastPath API enable you to get information about seasons, fixtures, squads and actions within a specific fixture. It also gives you statistical information about a game.

Our API Reference is organized around core betting workflows: listing all seasons, managing fixtures, getting squads, and listing actions. This API is mainly used by betting and media customers.

The FastPath API follows the general patterns of REST.

Seasons

List all seasons and competitions.

The Seasons API lets developers list and manage competition seasons. This is a gateway into the Fixtures API.

Applications don't need any input to list all seasons, however information can be filtered by start date and end date. The result is useful for obtaining competiton Ids, season Ids, and stage Ids.

Endpoints

List seasons

GET https://dde-api.data.imgarena.com/{sport}/seasons

Retrieves a list of seasons for a specific sport.

Path Parameters

Name

Type

Description

Query Parameters

Name

Type

Description

Headers

Name

Type

Description

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

{
    "id": "ca1829d1-fc05-455a-90e1-1692b2eb1306",
        "name": "Season 2022/2023",
        "startDateUTC": "2022-09-19T00:00:00",
        "endDateUTC": "2022-10-31T00:00:00",
        "competition": {
            "id": "10d45772-74a0-4703-ae40-804591a0fb80",
            "name": "Israel League Cup",
            "category": {
                "id": 1,
                "name": "Men"
            },
            "location": {
                "name": "Israel",
                "country": {},
                "continent": {
                    "name": "Asia"
                }
            }
        },
        "stages": [
            {
                "id": "b14d07d6-77ac-4aae-abbd-8da9125cfbf2",
                "name": "Regular Round",
                "startDateUTC": "2022-09-19T00:00:00",
                "endDateUTC": "2022-10-31T00:00:00",
                "rounds": [],
                "groups": []
            }
        ]on
}

Response fields

The requested list of seasons.

Season attributes

id (uuid) - The FastPath-assigned ID of the season
name (string) - Name of the season
startDateUTC (datetime) - Start date of the season
endDateUTC (datetime) - End date of the season
competition (Competition) - Competition information within the season
stages (Stages) - Round of match within a competition

Competition

id (uuid) - The FastPath-assigned ID of the competition within the season
name (string) - Name of the competition. Example: Israel League Cup
category (Category) - Competition category information
location (Location) - Venue information of the competition

Tour

id (integer) -
name (string) -

Location

name (string) - Name of the venue. Example: Israel
country (List) - List of countries where the competition is played out
continent (object) - List of continents where the competition is played out

Continent

name (string) - Name of the continent where the seasion is located. Example: Asia

Stages

id (uuid) -
name (string) -
startDateUTC (datetime) -
endDateUTC (datetime) -
rounds (object) -
groups (object) -

Polling frequency

We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times - once per 12 hours

Fixtures

List all fixtures.

The Fixtures API lets developers list and manage season fixtures. This is a gateway into the Actions API.

Applications don't need any input to list all fixtures, however information can be filtered by start date and end date. The result is useful for obtaining competiton Ids, season Ids, and stage Ids.

Endpoints

List fixtures

GET https://dde-api.data.imgarena.com/{sport}/fixtures

Retrieves a list of seasons for a specific sport.

Path Parameters

Name

Type

Description

sport*

String

A unique name for the requested sport. Example: basketball, soccer, v2/volleyball, snooker

String

Query Parameters

Name

Type

Description

subscribed

Boolean

Lists the fixtures for which a user is licensed. Example: true, false

live

Boolean

Allows users to determine which fixtures are live and available based on a user's licence. Example: true, false

status

String

Allows clients to filter based on the status of a match or group of matches. Example: scheduled, live, completed, postponed

dateFrom

Date

DAllows clients to filter between specific dates. Example: 2023-01-01

dateTo

Date

Allows clients to filter between specific dates. Example: 2023-01-01

type

String

Allows clients to filter based on the type of a match or group of matches. Example: official, simulation, training

coverageLevel

String

Headers

Name

Type

Description

Accept*

String

application/vnd.imggaming.dde.api+json;version=1

Authorization*

String

Bearer ACCESS_TOKEN

Content-Type*

String

application/json

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

{
        "id": "2ffbf044-db53-43ea-9898-a43868ca014d",
        "name": "BC Lietkabelis Panevezys v Jonava BC Cbet",
        "status": "Scheduled",
        "type": "Official",
        "coverageLevel": "In Venue",
        "startDateUTC": "2023-01-07T15:00:00",
        "teams": [
            {
                "id": "f14fd931-a113-4a0b-9c5c-532057c96301",
                "name": "Jonava BC Cbet",
                "club": {
                    "id": "b6c236e8-b9df-4a65-ae01-932864572b93",
                    "name": "JONAVA BC CBET"
                },
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "homeTeam": false
            },
            {
                "id": "b184558c-d9dd-4ada-898d-520b3d387622",
                "name": "BC Lietkabelis Panevezys",
                "club": {
                    "id": "bda8ed69-da63-434e-8b79-a20980f32c2e",
                    "name": "BC LIETKABELIS PANEVEZYS"
                },
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "homeTeam": true
            }
        ],
        "stage": {
            "id": "96afe2dd-58e7-435d-a9f9-999d64ec8b86",
            "name": "Regular round",
            "season": {
                "id": "7ac2140e-dd57-404a-bc3a-54d7fcd97343",
                "name": "Season 2022/2023",
                "startDateUTC": "2022-09-24T12:00:00",
                "endDateUTC": "2023-05-31T12:00:00",
                "competition": {
                    "id": "5c50bf20-7b5e-4d19-b2fe-aa1d20a042b2",
                    "name": "Lithuania LKL",
                    "category": {
                        "id": 1,
                        "name": "Men"
                    },
                    "tour": {
                        "id": 45,
                        "name": "Lithuanian Basketball Federation (LKF)"
                    },
                    "location": {
                        "name": "Lithuania",
                        "country": {},
                        "continent": {
                            "name": "Europe"
                        }
                    }
                }
            },
            "startDateUTC": "2022-09-24T12:00:00",
            "endDateUTC": "2023-05-31T12:00:00"
        },
        "venue": {
            "id": "7d30af55-89e2-4b50-a107-db133dcb3730",
            "name": "Cido Arena",
            "location": {
                "name": "Panevezys",
                "country": {
                    "name": "Lithuania"
                },
                "continent": {
                    "name": "Europe"
                }
            }
        }
    }

List season fixtures

GET https://dde-api.data.imgarena.com/{sport}/seasons/{seasonId}/fixtures

Path Parameters

Name

Type

Description

sport*

String

A unique name for the requested sport. Example: basketball, soccer, v2/volleyball, snooker

seasonId*

UUID

unique id of a requested season

Query Parameters

Name

Type

Description

subscribed

Boolean

Lists the fixtures for which a user is licensed. Example: true, false

live

Boolean

Allows users to determine which fixtures are live and available based on a user's licence. Example: true, false

status

String

Allows clients to filter based on the status of a match or group of matches. Example: scheduled, live, completed, postponed

dateFrom

Date

Allows clients to filter between specific dates. Example: 2023-01-01

dateTo

Date

Allows clients to filter between specific dates. Example: 2023-01-01

type

String

Allows clients to filter based on the type of a match or group of matches. Example: official, simulation, training

{
        "id": "ffc47dc5-61e1-44e9-add7-6088c415aa42",
        "name": "Hapoel Tel Aviv v Ironi Kiryat Ata",
        "status": "Completed",
        "type": "Official",
        "coverageLevel": "In Venue",
        "startDateUTC": "2022-09-19T17:00:00",
        "teams": [
            {
                "id": "114aa40d-6895-48b9-9bfe-0abecc9d10c9",
                "name": "Hapoel Tel Aviv",
                "club": {
                    "id": "3bf65514-d1b3-4768-8119-cee69b574734",
                    "name": "HAPOEL TEL AVIV"
                },
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "homeTeam": true
            },
            {
                "id": "d4407cea-1880-4afa-8aa6-9c58b2d583f4",
                "name": "Ironi Kiryat Ata",
                "club": {
                    "id": "da2da316-8876-4939-873b-d4ce5bff3688",
                    "name": "IRONI KIRYAT ATA"
                },
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "homeTeam": false
            }
        ],
        "stage": {
            "id": "7eb6159c-94bf-45bd-a52d-4143fdbe47d0",
            "name": "Regular round",
            "season": {
                "id": "c7e3e6b7-e24f-4e76-8247-6d4626d17935",
                "name": "Season 2022/2023",
                "startDateUTC": "2022-09-19T12:00:00",
                "endDateUTC": "2023-05-31T12:00:00",
                "competition": {
                    "id": "7d6aeba6-2599-4231-a0f9-fd218f38bced",
                    "name": "Israel League Cup",
                    "category": {
                        "id": 1,
                        "name": "Men"
                    },
                    "tour": {
                        "id": 37,
                        "name": "Israeli Basketball Association (IBBA)"
                    },
                    "location": {
                        "name": "Israel",
                        "country": {},
                        "continent": {
                            "name": "Asia"
                        }
                    }
                }
            },
            "startDateUTC": "2022-11-01T12:00:00",
            "endDateUTC": "2023-05-31T12:00:00"
        },
        "venue": {
            "id": "665e9df6-4587-41b4-9a75-085e56e8579b",
            "name": "Drive in Arena",
            "location": {
                "name": "Tel Aviv",
                "country": {
                    "name": "Israel"
                },
                "continent": {
                    "name": "Asia"
                }
            }
        }
    }

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

Get fixture

GET https://dde-api.data.imgarena.com/{sport}/fixtures/{fixtureId}

Path Parameters

Name

Type

Description

sport*

String

A unique name for the requested sport. Example: basketball, soccer, v2/volleyball, snooker

fixtureId*

UUID

Unique id of a requested fixture.

{
    "id": "ffc47dc5-61e1-44e9-add7-6088c415aa42",
    "name": "Hapoel Tel Aviv v Ironi Kiryat Ata",
    "status": "Completed",
    "type": "Official",
    "coverageLevel": "In Venue",
    "startDateUTC": "2022-09-19T17:00:00",
    "teams": [
        {
            "id": "114aa40d-6895-48b9-9bfe-0abecc9d10c9",
            "name": "Hapoel Tel Aviv",
            "club": {
                "id": "3bf65514-d1b3-4768-8119-cee69b574734",
                "name": "HAPOEL TEL AVIV"
            },
            "category": {
                "id": 1,
                "name": "Men"
            },
            "homeTeam": true
        },
        {
            "id": "d4407cea-1880-4afa-8aa6-9c58b2d583f4",
            "name": "Ironi Kiryat Ata",
            "club": {
                "id": "da2da316-8876-4939-873b-d4ce5bff3688",
                "name": "IRONI KIRYAT ATA"
            },
            "category": {
                "id": 1,
                "name": "Men"
            },
            "homeTeam": false
        }
    ],
    "stage": {
        "id": "7eb6159c-94bf-45bd-a52d-4143fdbe47d0",
        "name": "Regular round",
        "season": {
            "id": "c7e3e6b7-e24f-4e76-8247-6d4626d17935",
            "name": "Season 2022/2023",
            "startDateUTC": "2022-09-19T12:00:00",
            "endDateUTC": "2023-05-31T12:00:00",
            "competition": {
                "id": "7d6aeba6-2599-4231-a0f9-fd218f38bced",
                "name": "Israel League Cup",
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "tour": {
                    "id": 37,
                    "name": "Israeli Basketball Association (IBBA)"
                },
                "location": {
                    "name": "Israel",
                    "country": {},
                    "continent": {
                        "name": "Asia"
                    }
                }
            }
        },
        "startDateUTC": "2022-11-01T12:00:00",
        "endDateUTC": "2023-05-31T12:00:00"
    },
    "venue": {
        "id": "665e9df6-4587-41b4-9a75-085e56e8579b",
        "name": "Drive in Arena",
        "location": {
            "name": "Tel Aviv",
            "country": {
                "name": "Israel"
            },
            "continent": {
                "name": "Asia"
            }
        }
    }
}

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

Response fields

The requested list of seasons

Fixture attributes

id (uuid) - The FastPath-assigned ID of the fixture
name (string) - Descriptive name of the fixture
startDateUTC (datetime) - Start date of the fixture
status (string) - Competition information within the season
type (string) - Round of match within a competition
coverageLevel (string) - Round of match within a competition
teams (Teams) - Round of match within a competition
stage (Stage) - Round of match within a competition
venue (Venue) - Round of match within a competition

Teams

id (uuid) - The FastPath-assigned ID of the competition within the season
name (string) - Name of the competition. Example: Israel League Cup
club (Club) - Competition category information
category (Category) - Competition category information
homeTeam (boolean) - Venue information of the competition

Club

name

Stage

id (uuid) -
name (string) -
season (Season) -
startDateUTC (datetime) -
endDateUTC (datetime) -
rounds (object) -
groups (object) -

Venue

id (string) - The FastPath-assigned id of the venue. Example: 665e9df6-4587-41b4-9a75-085e56e8579b
name (string) - Descriptive name of the venue. Example: Drive in Arena
location (Location) - Geographic location of the venue. Usually it is the city, country and continent. Example: Tel Aviv, Israel, Asia

Location

name (string) - Name of the venue. Example: Tel Aviv
country (Country) - List of countries where the fixture is played out. Example: Israel
continent (Continent) - List of continents where the fixture is played out. Example: Asia

Country

name (string) - Name of the country where the fixture plays out

Continent

name (string) - Name of the continent where the fixture plays out

Polling frequency

We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times - once per 12 hours

Fixtures (old)

This endpoint returns the competition fixtures for a specific season. Per each competition, this endpoint will return the following information:

Name of the competition
Fixture date and kick-off time
Home and Away team (with IDs)
Venue
Stage/Round/Group information
Status (scheduled, live, completed, postponed)

Endpoint URLs

Live Fixtures (Subscribed):

https://dde-api.data.imgarena.com/basketball/fixtures?live=true&subscribed=true

https://dde-api.data.imgarena.com/basketball/seasons/{seasonId}/fixtures?live=true&subscribed=true

This allows clients to determine which fixtures are live and available based on a user's licence. The top URL shows all live fixtures and the bottom shows all live fixtures within that seasonId.

Fixtures (Subscribed):

https://dde-api.data.imgarena.com/basketball/fixtures?subscribed=true

https://dde-api.data.imgarena.com/basketball/seasons/{seasonId}/fixtures?subscribed=true

The top URL lists the fixtures for which you a user is licensed, and the bottom URL the fixtures within a specific seasonId, that a user is licensed for.

All Fixtures (Unsubscribed):

https://dde-api.data.imgarena.com/basketball/fixtures

https://dde-api.data.imgarena.com/basketball/seasons/{seasonId}/fixtures

This top URL lists the fixtures for all competitions (licensed and unlicensed). This is useable for an operator to see what which competitions might be available to purchase from IMGA. The bottom URL is a list of fixtures for a specific seasonId, both licensed and unlicensed.

Single Fixture

https://dde-api.data.imgarena.com/basketball/fixtures/{fixtureId}

This allows clients to determine the details for a single fixture

Status & dateTo and dateFrom

https://dde-api.data.imgarena.com/basketball/fixtures?subscribed=true&status=scheduled&dateFrom=2022-07-07&dateTo=2022-07-10

This allows clients to filter based on the status of a match or group of matches and between specific dates. For example, the above URL would show all matches that are 'scheduled' that a client is a licensed for between 7th July 2022 and 10th July 2022. These additional parameters can be used in conjunction with other support parameters like ?live=true and also be utilised with seasonId to allow a user to filter by status and dateTo and dateFrom within a certain season.

Supported status values are 'scheduled', 'live', 'completed', 'postponed'

Type

Type parameter allows a user to call the fixtures API by 'Official', 'Simulation' or 'Training'. Official will denote any official match collected by our data collection team, Simulation is generally any match we simulate and Training is for internal data collection training.

https://dde-api.data.imgarena.com/basketball/fixtures?dateFrom=2022-09-01&dateTo=2022-09-30&type=official

Polling Frequency

We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times:

Required Headers

Response Model

For sample JSON files and details of each value with descriptions within the payloads, utilise the following Swagger Pages:

Squads

This endpoint returns the competition squads for a specific season. Per each competition, this endpoint will return the following information:

Name of the competition
Team name & Id
Player forename, lastname and Id
Shirt Number
Nationality

Endpoint URLs

Squads

This allows clients to determine which players are associated to which team and seasonId - https://dde-api.data.imgarena.com/basketball/seasons/{seasonId}/squads
This allows clients to call by teamId - https://dde-api.data.imgarena.com/basketball/squads/{teamId}

Polling Frequency

We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times:

REST Endpoint

Frequency

Description

/basketball/seasons/{seasonId}/squads

Once per 24 hours

Updated on any change to a team and their squad such as a player being called up, a player transfer etc.

Required Headers

Key

Value

application/vnd.imggaming.dde.api+json;version=1

Content-Type

application/json

Authorization

Bearer eyvhaoudfgpdfgo*

Response Model

For sample JSON files and details of each value with descriptions within the payloads, utilise the following Swagger Pages:

JSON Schema - https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/basketball/get_basketball_seasons__seasonId__squads

JSON Schema with value descriptions - https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/SeasonSquad

Actions

This REST API endpoint returns all match action packets in a single URL call (which are typically delivered in the 'Live Actions' websocket). Crucially these match action packets are delivered in the API call at the END of the fixture.

The data contained will include all team and player actions happening within the soccer match - this will include; goals, cards, shots and more. For a list of all match actions that are supported, as well as definitions of these actions, please see the following documentation page.

Endpoint URL

https://dde-api.data.imgarena.com/basketball/fixtures/{fixtureId}/actions

N.B. – Please insert the relevant fixtureId returned from the fixtures API endpoint to return the data. The authentication token provided will be required to make a connection to this websocket endpoint.

Polling Frequency

We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times:

REST Endpoint

Frequency

Description

Required Headers

Response Model

Please see the live actions websocket 'Response Model' section to understand the actions, definitions. Below is also a small snippet of the JSON schema.

[
    {
        "version": 2,
        "finished": false,
        "fixtureAction": {
            "period": 0,
            "actionId": "2e4a8391-1413-4237-9549-32b550e806cb",
            "metadata": {
                "awayTeamColour": "255, 242, 0",
                "homeTeamColour": "0, 38, 255"
            },
            "sendType": "Confirmed",
            "clockTime": "00:00",
            "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
            "timestamp": "2022-11-06T10:32:49.914282Z",
            "sendTypeId": 5,
            "fixtureSeqNum": 1,
            "timelineSequence": 1.0E-16,
            "fixtureActionType": "Team Colours",
            "fixtureActionTypeId": 2
        },
        "fixtureSummary": {
            "isTied": true,
            "periods": [],
            "awayTeamScore": 0,
            "currentPeriod": 1,
            "currentStatus": "Scheduled",
            "homeTeamScore": 0,
            "currentClockTime": "10:00"
        }
    },
    {
        "version": 2,
        "finished": false,
        "fixtureAction": {
            "period": 0,
            "actionId": "6af2a7f3-866d-4ac1-acf5-47770f57c324",
            "metadata": {
                "pitchConditions": {
                    "quality": 2,
                    "surface": 2
                },
                "weatherConditions": {
                    "rain": 0,
                    "wind": 0,
                    "temperature": 2
                }
            },
            "sendType": "Confirmed",
            "clockTime": "00:00",
            "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
            "timestamp": "2022-11-06T10:32:58.613092Z",
            "sendTypeId": 5,
            "fixtureSeqNum": 2,
            "timelineSequence": 2.0E-16,
            "fixtureActionType": "Match Conditions",
            "fixtureActionTypeId": 1
        },
        "fixtureSummary": {
            "isTied": true,
            "periods": [],
            "awayTeamScore": 0,
            "currentPeriod": 1,
            "currentStatus": "Scheduled",
            "homeTeamScore": 0,
            "currentClockTime": "10:00"
        }
    },
    {
        "version": 2,
        "finished": false,
        "fixtureAction": {
            "period": 0,
            "actionId": "f72a0a93-699d-4825-891e-6bcff47ce22e",
            "metadata": {
                "latitude": 43.358986,
                "longitude": 19.358965
            },
            "sendType": "Confirmed",
            "clockTime": "00:00",
            "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
            "timestamp": "2022-11-06T10:33:06.013523Z",
            "sendTypeId": 5,
            "fixtureSeqNum": 3,
            "timelineSequence": 3.0E-16,
            "fixtureActionType": "Device Location",
            "fixtureActionTypeId": 19
        },
        "fixtureSummary": {
            "isTied": true,
            "periods": [],
            "awayTeamScore": 0,
            "currentPeriod": 1,
            "currentStatus": "Scheduled",
            "homeTeamScore": 0,
            "currentClockTime": "10:00"
        }
    },
    {
        "version": 2,
        "finished": false,
        "fixtureAction": {
            "team": {
                "id": "02ed1f32-385f-4e0f-b78f-390a498d34af",
                "name": "Rudar"
            },
            "period": 0,
            "actionId": "5c8c565c-9ab2-4bbf-a1eb-600ef48d33a7",
            "metadata": {
                "teamId": "02ed1f32-385f-4e0f-b78f-390a498d34af",
                "substitutes": [
                    {
                        "id": "d2036fff-aeee-4702-94e4-1dfd123cabb0",
                        "fullName": "Pavle Brajkovic",
                        "lastName": "Brajkovic",
                        "firstName": "Pavle",
                        "shirtNumber": "14"
                    },
                    {
                        "id": "bae0ee19-06de-4e3b-a7e0-b4c88426b188",
                        "fullName": "Stefan Tanjevic",
                        "lastName": "Tanjevic",
                        "firstName": "Stefan",
                        "shirtNumber": "12"
                    },
                    {
                        "id": "f6540429-82d0-4af0-a00b-d4fd4ada0015",
                        "fullName": "Mitar Vranes",
                        "lastName": "Vranes",
                        "firstName": "Mitar",
                        "shirtNumber": "7"
                    },
                    {
                        "id": "8069a0ec-64e8-4a66-8037-98f847d4794b",
                        "fullName": "Luka Subaric",
                        "lastName": "Subaric",
                        "firstName": "Luka",
                        "shirtNumber": "4"
                    },
                    {
                        "id": "b8a14c88-e899-4b4f-91e6-934437579a50",
                        "fullName": "Janko Petrovic",
                        "lastName": "Petrovic",
                        "firstName": "Janko",
                        "shirtNumber": "8"
                    },
                    {
                        "id": "5a55e905-5721-4cba-803e-f5e7717b0ecc",
                        "fullName": "Petar Vojinovic",
                        "lastName": "Vojinovic",
                        "firstName": "Petar",
                        "shirtNumber": "15"
                    },
                    {
                        "id": "6187e8a7-7af6-472f-b35d-7973ea7b0ff7",
                        "fullName": "Sinisa Terzic",
                        "lastName": "Terzic",
                        "firstName": "Sinisa",
                        "shirtNumber": "10"
                    }
                ],
                "startingLineup": [
                    {
                        "id": "3cb4b214-6cdc-4895-8fae-234b19f0b889",
                        "fullName": "Vladimir Starovlah",
                        "lastName": "Starovlah",
                        "firstName": "Vladimir",
                        "shirtNumber": "16"
                    },
                    {
                        "id": "4b6fe5e8-5f0a-4f59-bdef-f5ff54bce28d",
                        "fullName": "Dejan Dzakovic",
                        "lastName": "Dzakovic",
                        "firstName": "Dejan",
                        "shirtNumber": "11"
                    },
                    {
                        "id": "a151a91d-f2cf-44a6-8b09-50032e8f1d53",
                        "fullName": "NIkola Cupara",
                        "lastName": "Cupara",
                        "firstName": "NIkola",
                        "shirtNumber": "9"
                    },
                    {
                        "id": "d7962172-4189-4389-875f-8c704ec07dec",
                        "fullName": "Andrija Starcevic",
                        "lastName": "Starcevic",
                        "firstName": "Andrija",
                        "shirtNumber": "5"
                    },
                    {
                        "id": "48227027-9765-4336-9998-6f4fd9ecc300",
                        "fullName": "Danilo Subaric",
                        "lastName": "Subaric",
                        "firstName": "Danilo",
                        "shirtNumber": "13"
                    }
                ]
            },
            "sendType": "Confirmed",
            "clockTime": "00:00",
            "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
            "timestamp": "2022-11-06T11:23:39.227535Z",
            "sendTypeId": 5,
            "fixtureSeqNum": 4,
            "timelineSequence": 4.0E-16,
            "fixtureActionType": "Lineups",
            "fixtureActionTypeId": 3
        },
        "fixtureSummary": {
            "isTied": true,
            "periods": [],
            "awayTeamScore": 0,
            "currentPeriod": 1,
            "currentStatus": "LineUps",
            "homeTeamScore": 0,
            "currentClockTime": "10:00"
        }
    },
    {
        "version": 2,
        "finished": false,
        "fixtureAction": {
            "team": {
                "id": "b86946a8-90a6-42ce-be64-79984b085bf2",
                "name": "Podgorica II"
            },
            "period": 0,
            "actionId": "65f4dab0-9107-4800-b531-e6e26360e69a",
            "metadata": {
                "teamId": "b86946a8-90a6-42ce-be64-79984b085bf2",
                "substitutes": [
                    {
                        "id": "bb9fddcb-a53f-4e1d-98fb-cbeddbd85e5b",
                        "fullName": "Boris Perucica",
                        "lastName": "Perucica",
                        "firstName": "Boris",
                        "shirtNumber": "13"
                    },
                    {
                        "id": "d5e7086b-bf37-4609-a504-558f105ac17c",
                        "fullName": "Petar Pinter",
                        "lastName": "Pinter",
                        "firstName": "Petar",
                        "shirtNumber": "15"
                    },
                    {
                        "id": "03397d8d-9e82-4173-a18c-44fb5e644238",
                        "fullName": "Lazar Mirotic",
                        "lastName": "Mirotic",
                        "firstName": "Lazar",
                        "shirtNumber": "5"
                    },
                    {
                        "id": "2b8e5aa3-aae4-4845-9460-1ac598526291",
                        "fullName": "Petar Radonjić",
                        "lastName": "Radonjić",
                        "firstName": "Petar",
                        "shirtNumber": "1"
                    },
                    {
                        "id": "f788e49e-a277-401b-b212-69dd93d25b95",
                        "fullName": "Aljosa Draskovic",
                        "lastName": "Draskovic",
                        "firstName": "Aljosa",
                        "shirtNumber": "0"
                    },
                    {
                        "id": "a0b1d33e-6ffe-4e91-8b65-da561558a349",
                        "fullName": " Jevric",
                        "lastName": "Jevric",
                        "firstName": null,
                        "shirtNumber": "6"
                    },
                    {
                        "id": "1e33f7b8-b43c-485f-89f3-f1d9f741fbe2",
                        "fullName": "Aleksa Janicic",
                        "lastName": "Janicic",
                        "firstName": "Aleksa",
                        "shirtNumber": "3"
                    }
                ],
                "startingLineup": [
                    {
                        "id": "9bb6ed80-9022-4bc1-8ef2-b2f9c0b56971",
                        "fullName": "Marko Radunović",
                        "lastName": "Radunović",
                        "firstName": "Marko",
                        "shirtNumber": "8"
                    },
                    {
                        "id": "c96fd964-14d2-46d6-9f3e-51a3113e891f",
                        "fullName": "Petar Strugar",
                        "lastName": "Strugar",
                        "firstName": "Petar",
                        "shirtNumber": "4"
                    },
                    {
                        "id": "c038ff22-be9e-49fc-a670-3ef064003cda",
                        "fullName": "Amar Hot",
                        "lastName": "Hot",
                        "firstName": "Amar",
                        "shirtNumber": "7"
                    },
                    {
                        "id": "b1514269-cb62-42a1-a47f-c0fbf4a2e852",
                        "fullName": "Andrija Sutovic",
                        "lastName": "Sutovic",
                        "firstName": "Andrija",
                        "shirtNumber": "2"
                    },
                    {
                        "id": "9fc6b884-c566-4629-9665-01d59fe80d89",
                        "fullName": "Lazar Vukčević",
                        "lastName": "Vukčević",
                        "firstName": "Lazar",
                        "shirtNumber": "14"
                    }
                ]
            },
            "sendType": "Confirmed",
            "clockTime": "00:00",
            "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
            "timestamp": "2022-11-06T11:23:39.227607Z",
            "sendTypeId": 5,
            "fixtureSeqNum": 5,
            "timelineSequence": 5.0E-16,
            "fixtureActionType": "Lineups",
            "fixtureActionTypeId": 3
        },
        "fixtureSummary": {
            "isTied": true,
            "periods": [],
            "awayTeamScore": 0,
            "currentPeriod": 1,
            "currentStatus": "LineUps",
            "homeTeamScore": 0,
            "currentClockTime": "10:00"
        }
    },
    {
        "version": 2,
        "finished": false,
        "fixtureAction": {
            "period": 0,
            "actionId": "388ccebd-9832-4dd3-9f83-59c6e3cea19c",
            "metadata": {
                "awayTeamColour": "0, 145, 255",
                "homeTeamColour": "22, 80, 13"
            },
            "sendType": "Updated",
            "clockTime": "00:00",
            "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
            "timestamp": "2022-11-06T11:24:17.264608Z",
            "sendTypeId": 2,
            "fixtureSeqNum": 6,
            "timelineSequence": 6.0E-16,
            "fixtureActionType": "Team Colours",
            "fixtureActionTypeId": 2
        },
        "fixtureSummary": {
            "isTied": true,
            "periods": [],
            "awayTeamScore": 0,
            "currentPeriod": 1,
            "currentStatus": "LineUps",
            "homeTeamScore": 0,
            "currentClockTime": "10:00"
        }
    },
    {
        "version": 2,
        "finished": true,
        "fixtureAction": {
            "period": 0,
            "actionId": "5c6bf0ad-2124-77b6-853b-66f27abed59d",
            "sendType": "Confirmed",
            "clockTime": "00:00",
            "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
            "timestamp": "2022-11-06T13:17:06.905002Z",
            "sendTypeId": 5,
            "fixtureSeqNum": 1535,
            "timelineSequence": 1.535E-13,
            "fixtureActionType": "Post Match Check Complete",
            "fixtureActionTypeId": 21
        },
        "fixtureSummary": {
            "isTied": false,
            "periods": [
                {
                    "id": 1,
                    "end": "2022-11-06T11:53:57",
                    "type": "Regular",
                    "label": "1st quarter",
                    "start": "2022-11-06T11:34:56",
                    "awayTeamScore": 15,
                    "homeTeamScore": 16,
                    "awayTeamPeriodScore": 15,
                    "homeTeamPeriodScore": 16
                },
                {
                    "id": 2,
                    "end": "2022-11-06T12:22:35",
                    "type": "Regular",
                    "label": "2nd quarter",
                    "start": "2022-11-06T11:56:16",
                    "awayTeamScore": 34,
                    "homeTeamScore": 35,
                    "awayTeamPeriodScore": 19,
                    "homeTeamPeriodScore": 19
                },
                {
                    "id": 3,
                    "end": "2022-11-06T12:57:43",
                    "type": "Regular",
                    "label": "3rd quarter",
                    "start": "2022-11-06T12:37:22",
                    "awayTeamScore": 60,
                    "homeTeamScore": 52,
                    "awayTeamPeriodScore": 26,
                    "homeTeamPeriodScore": 17
                },
                {
                    "id": 4,
                    "end": "2022-11-06T13:15:41",
                    "type": "Regular",
                    "label": "4th quarter",
                    "start": "2022-11-06T12:58:18",
                    "awayTeamScore": 80,
                    "homeTeamScore": 66,
                    "awayTeamPeriodScore": 20,
                    "homeTeamPeriodScore": 14
                }
            ],
            "awayTeamScore": 80,
            "currentPeriod": 4,
            "currentStatus": "Completed",
            "homeTeamScore": 66,
            "currentClockTime": "10:00"
        }
    },
    {
        "version": 2,
        "finished": false,
        "fixtureAction": {
            "period": 1,
            "actionId": "cced72d5-fe44-46c2-b39f-6a69f0e772cd",
            "sendType": "Confirmed",
            "clockTime": "10:00",
            "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
            "timestamp": "2022-11-06T11:34:56.501369Z",
            "sendTypeId": 5,
            "fixtureSeqNum": 7,
            "timelineSequence": 1.0000000000000007,
            "fixtureActionType": "Start Fixture",
            "fixtureActionTypeId": 4
        },
        "fixtureSummary": {
            "isTied": true,
            "periods": [],
            "awayTeamScore": 0,
            "currentPeriod": 1,
            "currentStatus": "LineUps",
            "homeTeamScore": 0,
            "currentClockTime": "10:00"
        }
    },
    {
        "version": 2,
        "finished": false,
        "fixtureAction": {
            "period": 1,
            "actionId": "20501081-3f7b-48b8-a48e-16bbff2fffbb",
            "sendType": "Confirmed",
            "clockTime": "10:00",
            "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
            "timestamp": "2022-11-06T11:34:56.501441Z",
            "sendTypeId": 5,
            "fixtureSeqNum": 8,
            "timelineSequence": 1.0000000000000009,
            "fixtureActionType": "Start Period",
            "fixtureActionTypeId": 6
        },
        "fixtureSummary": {
            "isTied": true,
            "periods": [
                {
                    "id": 1,
                    "end": null,
                    "type": "Regular",
                    "label": "1st quarter",
                    "start": "2022-11-06T11:34:56",
                    "awayTeamScore": 0,
                    "homeTeamScore": 0,
                    "awayTeamPeriodScore": 0,
                    "homeTeamPeriodScore": 0
                }
            ],
            "awayTeamScore": 0,
            "currentPeriod": 1,
            "currentStatus": "Live",
            "homeTeamScore": 0,
            "currentClockTime": "10:00"
        }
    },
    {
        "version": 2,
        "finished": false,
        "fixtureAction": {
            "period": 1,
            "actionId": "d32de188-643c-4095-ad1e-8934ad62356c",
            "sendType": "Confirmed",
            "clockTime": "10:00",
            "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
            "timestamp": "2022-11-06T11:34:56.501443Z",
            "sendTypeId": 5,
            "fixtureSeqNum": 9,
            "timelineSequence": 1.0000000000000009,
            "fixtureActionType": "Start Clock",
            "fixtureActionTypeId": 8
        },
        "fixtureSummary": {
            "isTied": true,
            "periods": [
                {
                    "id": 1,
                    "end": null,
                    "type": "Regular",
                    "label": "1st quarter",
                    "start": "2022-11-06T11:34:56",
                    "awayTeamScore": 0,
                    "homeTeamScore": 0,
                    "awayTeamPeriodScore": 0,
                    "homeTeamPeriodScore": 0
                }
            ],
            "awayTeamScore": 0,
            "currentPeriod": 1,
            "currentStatus": "Live",
            "homeTeamScore": 0,
            "currentClockTime": "09:59"
        }
    },
    {
        "version": 2,
        "finished": false,
        "fixtureAction": {
            "team": {
                "id": "02ed1f32-385f-4e0f-b78f-390a498d34af",
                "name": "Rudar"
            },
            "period": 1,
            "player": {
                "id": "4b6fe5e8-5f0a-4f59-bdef-f5ff54bce28d",
                "name": "Dejan Dzakovic"
            },
            "actionId": "01693124-3b3c-4c34-8606-551ce33cac9f",
            "metadata": {
                "courtPosition": {
                    "x": -221.0,
                    "y": 370.0,
                    "zone": "AboveTheBreak3"
                }
            },
            "sendType": "Pending",
            "clockTime": "09:44",
            "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
            "timestamp": "2022-11-06T11:35:12.527233Z",
            "sendTypeId": 1,
            "fixtureSeqNum": 10,
            "timelineSequence": 1.000000015610556,
            "fixtureActionType": "3PT Shot",
            "fixtureActionTypeId": 233
        },
        "fixtureSummary": {
            "isTied": true,
            "periods": [
                {
                    "id": 1,
                    "end": null,
                    "type": "Regular",
                    "label": "1st quarter",
                    "start": "2022-11-06T11:34:56",
                    "awayTeamScore": 0,
                    "homeTeamScore": 0,
                    "awayTeamPeriodScore": 0,
                    "homeTeamPeriodScore": 0
                }
            ],
            "awayTeamScore": 0,
            "currentPeriod": 1,
            "currentStatus": "Live",
            "homeTeamScore": 0,
            "currentClockTime": "09:44"
        }

Stream Endpoints (Websocket)

Live Actions

The Live Actions websocket contains a live 'stream' of the team and player actions happening within the basketball match - this will include; 3 points made, free throws, steals, turnovers and more.

You should receive a new update any time a key action is completed and this websocket is crucial for powering live scores and match actions.

The authentication token provided will be required to make a connection to this websocket endpoint.

Once you have the API token, any further data that you send over the connection will be ignored.

N.B – This endpoint sends heartbeats in-between data packets to let you know that it is still connected.

Endpoint URL

wss://dde-streams.data.imgarena.com/media/basketball/fixtures/{fixtureId}/actions

wss://dde-streams.data.imgarena.com/media/basketball/fixtures/{fixtureId}/actions

CONNECT wss://dde-streams.data.imgarena.com/media/basketball/fixtures/{fixtureId}/actions

Headers

Name

Type

Description

Accept*

String

application/vnd.imggaming.dde.api+json;version=1

Authorization*

String

Bearer {token}

Connection*

String

keep-alive

{
    The supplied authentication is invalid
}

{
    Request is missing required HTTP header 'Accept'
}

N.B. – Please insert the relevant fixtureId returned from the fixtures API endpoint to return you the data. The authentication token provided will be required to make a connection to this websocket endpoint.

Process for connecting to the web socket endpoints

Connect to SSL websocket address
Send JSON packet containing API token
Receive response indicating that connection is authorised (or a response indicating why the connection cannot be made)
Receive heartbeat packets every 10 seconds to verify the connection is live
Receive data packets

Once you have the API token, any further data that you send over the connection will be ignored. This endpoint sends heartbeats in-between data packets to let you know that it is still connected.

Request parameters

There are 2 optional params, that are in common with these Websocket endpoints:

“speed” - this can be “fast” or “normal”. Default is normal and only applicable for offline matches
“startPosition” : integer value, default is 0. This is how many events to skip from the beginning of the list of events. e.g. 5 would be start sending events from the 5th event received for that websocket. This is a useful feature if you want to continue without getting all the events again from the beginning when you reconnect

Polling limits

Response Model

For sample JSON files and details of each value with descriptions within the payloads, utilise the following Swagger Pages:

JSON Schema https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/basketball/getActionsByFixtureId

JSON Schema with value descriptions https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/ActionMessage

Action Types

The below information details the key FastPath actions and sub action types we will be collecting live and distributing via the live Actions WebSocket.

An action type can be something like a goal, card, dangerous attack. The sub action type gives extra context to that initial action type. i.e. a goal (action type) scored from inside the box (sub action type).

ACTION TYPE ID

ACTION NAME

DESCRIPTION

v2 (Basic)

v3 (Enhanced)

PLAYER

Response Model

This section details and describes the values within the actions payload (replaces the swagger actions websocket doc)

Periods Object

Field Name

Type

Example

Description

integer

The period id 1 - 1st quarter 2 - 2nd quarter 3 - 3rd quarter 4 - 4th quarter 5 - overtime (optional)

label

string

1st quarter

The string value relating to the period

type

string

Regular

The match type

start

date / time

2022-09-25T14:39:51

The start date and time of that period

end

date / time

2022-09-25T14:20:57e

The end date and time of that period

awayTeamScore

integer

The overall away team score

homeTeamScore

integer

The overall home team score

awayTeamPeriodScore

integer

The away team score in that period

homeTeamPeriodScore

integer

The home team score in that period

"periods": [
                {
                    "id": 1,
                    "label": "1st quarter",
                    "type": "Regular",
                    "start": "2022-09-25T14:20:57",
                    "end": "2022-09-25T14:39:51",
                    "awayTeamScore": 15,
                    "homeTeamScore": 19,
                    "awayTeamPeriodScore": 15,
                    "homeTeamPeriodScore": 19
                }
            ]

Fixture Action Object

Field Name

Type

Example

Description

period

integer

The period Id

actionId

UUID

6ee3f4f6-e85c-448a-a13a-f5b85979337f

The id number of the action. This will be useful in linking actions that are pending, updated etc.

sendType

string

Confirmed

the send type name 1- Pending (possible action packet) 2- Updated (updates info on confirmed packets) 3- Cancelled (invalidates pending packet) 4-Deleted (deletes confirmed packets) 5-Confirmed (confirmed packet and can be added) 6-Restored (restored to previous state prior to deletion).

Note that Pending actions can be cancelled. Confirmed actions can be deleted and typically all key actions (card, goal, penalty) start with a pending state

clockTime

time

10:00

The value on the clock when the action was collected

fixtureId

UUID

2104e2e1-3439-4684-a146-28df3f89bda2

The unique fixture UUID

timestamp

date / time

2022-09-25T14:20:57.092100Z

The timestamp of the action delivered as yyyy-mm-ddThh:mm:ss.xxxxxxZ

sendTypeId

integer

the send type Id (as above)

fixtureSeqNum

integer

A deduplicated list of scorer sequence numbers based on the action creation time across all devices and all scorers.

timelineSequence

long

1.000000000000001

fixtureActionType

string

Start Fixture

The action type name (i.e. goal, shot etc) Full list of actions can be found above in Action Type & Sub Action Types section

fixtureActionTypeId

integer

The action type Id related to the fixtureActionType. Full list of actions can be found above in Action Type & Sub Action Types section

"fixtureAction": {
            "period": 1,
            "actionId": "6ee3f4f6-e85c-448a-a13a-f5b85979337f",
            "sendType": "Confirmed",
            "clockTime": "10:00",
            "fixtureId": "2104e2e1-3439-4684-a146-28df3f89bda2",
            "timestamp": "2022-09-25T14:20:57.092100Z",
            "sendTypeId": 5,
            "fixtureSeqNum": 11,
            "timelineSequence": 1.000000000000001,
            "fixtureActionType": "Start Fixture",
            "fixtureActionTypeId": 4
        }

Live Match Statistics - Box Score

This endpoint is a live match websocket endpoint that returns the full set up of player & team box score statistics and by period.

The authentication token provided will be required to make a connection to this websocket endpoint.

Once you have the API token, any further data that you send over the connection will be ignored.

N.B – This endpoint sends heartbeats in-between data packets to let you know that it is still connected.

This endpoint currently takes no request parameters

Endpoint URL

wss://dde-streams.data.imgarena.com/media/basketball/fixtures/{fixtureId}/statistics

Polling limits

Request Parameters

There are 2 optional params, that are in common with these Websocket endpoints:

“speed” - this can be “fast” or “normal”. Default is normal and only applicable for offline matches
“startPosition” : integer value, default is 0. This is how many events to skip from the beginning of the list of events. e.g. 5 would be start sending events from the 5th event received for that websocket. This is a useful feature if you want to continue without getting all the events again from the beginning when you reconnect

Full list of statistics

Team Stats

Biggest Lead
Biggest Lead Score
Current Scoring Run
Longest Scoring Run
Longest Scoring Run From Zero
Longest Scoring Run Score
Longest Scoring Run Score From Zero
Most Points in Period
Period With Most Points
Coach Ejected
Assists
Assists v Turnovers
Assists/Turnovers Ratio
Bench Points
Bench Technical Fouls
Blocks
Blocks Against
Coach Disqualifying Fouls
Coach Technical Fouls
Defensive Team Rebounds
Disqualifying Fouls
Field Goal Attempts
Field Goals Made
Field Goals %
Fouls Against
Free Throw Attempts
Free Throws Made
Free Throws %
Offensive Fouls
Offensive Rebounds
Offensive Team Rebounds
Personal Fouls
Points Off Turnovers
Second Chance Points
Steals
Team Limit Fouls
Team Rebounds
Technical Fouls
3 Pointers Attempted
3 Pointers Made
3 Pointers %
Total Points
Total Rebounds
Total Rebounds With Team Rebounds
Turnovers
2 Pointer Attempts
2 Pointers Made
2 Pointers %
Unsportsmanlike Fouls

Period Stats

Period
Assists
Assists To Turnovers
Assists to Turnovers Ratio
Bench Points
Bench Technical Fouls
Blocks
Blocks Against
Unsportsmanlike Fouls
Coach Disqualifying Fouls
Coach Technical Fouls
Defensive Rebounds
Defensive Team Rebounds
Disqualifying Fouls
Field Goal Attempts
Field Goals Made
Field Goals %
Fouls Against
Free Throw Attempts
Free Throws Made
Free Throws %
Offensive Fouls
Offensive Rebounds
Offensive Team Rebounds
Personal Fouls
Points Off Turnovers
Second Chance Points
Steals
Team Limit Fouls
Team Rebounds
Technical Fouls
3 Pointer Attempts
3 Pointers Made
3 Pointers %
Total Points
Total Rebounds
Total Rebounds With Team Rebounds
Turnovers
Two Pointer Attempts
Two Pointers Made
Two Pointers %
Unsportsmanlike Fouls

Player

Assists Ratio
Assists Ratio When On Court
Blocks Against Ratio
Blocks Against Ratio When On Court
Blocks Ratio
Blocks Ratio When On Court
Defensive Rebounds Ratio
Defensive Rebounds Ratio When On Court
Field Goals Attempts Ratio
Field Goals Attempts Ratio When On Court
Field Goals Made Ratio
Field Goals Made Ratio When On Court
Free Throw Attempts Ratio
Free Throw Attempts Ratio When On Court
Free Throws Made Ratio
Free Throws Made Ratio When On Court
Has Double Double
Has Quadruple Double
Has Triple Double
Offensive Rebounds Ratio
Offensive Rebounds Ratio When On Court
Steals Ratio
Steals Ratio When On Court
Team Assists When On Court
Team Blocks Against When On Court
Team Blocks When On Court
Team Defensive Rebounds When On Court
Team Field Goal Attempts When On Court
Team Field Goals Made When On Court
Team Free Throw Attempts When On Court
Team Free Throws Made When On Court
Team Offensive Rebounds When On Court
Team Steals When On Court
Team 3 Pointer Attempts When On Court
Team 3 Pointers Made When On Court
Team Total Points When On Court
Team Total Rebounds When On Court
Team Turnovers When On Court
Team 2 Pointer Attempts When On Court
Team 2 Pointers Made When On Court
3 Pointers Attempt Ratio
3 Pointers Attempt Ratio When On Court
3 Pointers Made Ratio
3 Pointers Made Ratio When On Court
Total Points Ratio
Total Points Ratio When On Court
Total Rebounds Ratio
Total Rebounds Ratio When On Court
Turnovers Ratio
Turnovers Ratio When On Court
2 Pointers Attempts Ratio
2 Pointers Attempts Ratio When On Court
2 Pointers Made Ratio
2 Pointers Made Ratio When On Court
Ejected
Fouled Out
Second Chance Points Ratio
Second Chance Points Ratio When On Court
Team Second Chance Points When On Court
Points Off Turnovers Ratio
Points Off Turnovers Ratio When On Court
Team Points Off Turnovers When On Court
Assists
Assists To Turnovers
Assists To Turnovers Ratio
Blocks
Blocks Against
Defensive Rebounds
Disqualifying Fouls
Field Goal Attempts
Field Goals Made
Field Goals %
Fouls Against
Free Throw Attempts
Free Throws Made
Free Throws %
Last Update Game Time
Minutes Played
Minutes Played String
Offensive Fouls
Offensive Rebounds
Personal Fouls
Player Limit Fouls
+/-
Points Off Turnovers
Second Chance Points
Steals
Technical Fouls
3 Pointer Attempts
3 Pointers Made
3 Pointers %
Total Points
Total Rebounds
Turnovers
2 Pointer Attempts
2 Pointers Made
2 Pointers %
Unsportsmanlike Fouls

Definitions

This section tags statistics to a Team, a Player or a specific period. Some stats may only be relevant for those categories.

Response Model

For sample JSON files and details of each value with descriptions within the payloads, utilise the following Swagger Pages:

Live Data Scenarios

Team Colours

{
   "fixtureAction":{
      "timestamp":"2022-07-08T14:38:15.178355Z",
      "actionId":"ed307900-3a30-49bc-a22c-d8a53ce5d34e",
      "fixtureSeqNum":9,
      "clockTime":"00:00",
      "fixtureActionType":"Team Colours",
      "fixtureActionTypeId":2,
      "sendTypeId":2,
      "sendType":"Updated",
      "fixtureId":"4781718f-bba3-4e7b-a16f-1ccddf91c28d",
      "metadata":{
         "awayTeamColour":"34, 180, 43",
         "homeTeamColour":"255, 199, 0"
      },
      "period":0
   },
   "fixtureSummary":{
      "awayTeamScore":0,
      "currentClockTime":"00:00",
      "periods":[
         
      ],
      "homeTeamScore":0,
      "isTied":true,
      "isHomeTeamInPossesion":false,
      "finished":false,
      "currentPeriod":1,
      "currentStatus":"Scheduled"
   },
   "version":1
}

Match Conditions

{
   "fixtureAction":{
      "timestamp":"2022-07-08T14:19:00.960947Z",
      "actionId":"5dd2898d-a35a-4ccf-b340-64953bae1ecf",
      "fixtureSeqNum":5,
      "clockTime":"00:00",
      "fixtureActionType":"Match Conditions",
      "fixtureActionTypeId":1,
      "sendTypeId":5,
      "sendType":"Confirmed",
      "fixtureId":"4781718f-bba3-4e7b-a16f-1ccddf91c28d",
      "metadata":{
         "pitchConditions":{
            "quality":"Good",
            "surface":"Grass"
         },
         "weatherConditions":{
            "rain":"None",
            "temperature":"Hot",
            "wind":"Low"
         }
      },
      "period":0
   },
   "fixtureSummary":{
      "awayTeamScore":0,
      "currentClockTime":"00:00",
      "periods":[
         
      ],
      "homeTeamScore":0,
      "isTied":true,
      "isHomeTeamInPossesion":false,
      "finished":false,
      "currentPeriod":1,
      "currentStatus":"Scheduled"
   },
   "version":1
}

Lineup

{
   "fixtureAction":{
      "timestamp":"2022-07-08T15:17:16.324929Z",
      "actionId":"f52ab76d-5102-4090-87fd-4a2219c41e59",
      "fixtureSeqNum":10,
      "clockTime":"00:00",
      "fixtureActionType":"Lineups",
      "fixtureActionTypeId":3,
      "sendTypeId":5,
      "sendType":"Confirmed",
      "team":{
         "id":"aba100e8-a29a-4bc3-8f87-eb669b34c5a7",
         "name":"Botev Plovdiv"
      },
      "fixtureId":"4781718f-bba3-4e7b-a16f-1ccddf91c28d",
      "metadata":{
         "startingLineup":[
            {
               "fullName":"Hidajet  Hankić",
               "lastName":"Hankić",
               "firstName":"Hidajet ",
               "id":"1811defb-e308-4f72-9a41-450aba7bae85",
               "shirtNumber":"13"
            },
            {
               "fullName":"Viktor  Genev",
               "lastName":"Genev",
               "firstName":"Viktor ",
               "id":"465dbb46-231e-4f42-b55d-ede0b51dbf21",
               "shirtNumber":"4"
            },
            {
               "fullName":"Emmanuel  Toku",
               "lastName":"Toku",
               "firstName":"Emmanuel ",
               "id":"e1696259-db6f-4f83-8d3c-e4f2c245b94b",
               "shirtNumber":"10"
            },
            {
               "fullName":"Jasper  van Heertum",
               "lastName":"van Heertum",
               "firstName":"Jasper ",
               "id":"b4216142-3d54-44cb-ac02-ae85134b9553",
               "shirtNumber":"24"
            },
            {
               "fullName":"Pa  Konate",
               "lastName":"Konate",
               "firstName":"Pa ",
               "id":"0f2ccd1d-5966-4026-bd8d-9e78cc11f498",
               "shirtNumber":"3"
            },
            {
               "fullName":"Antoine  Baroan",
               "lastName":"Baroan",
               "firstName":"Antoine ",
               "id":"914112d5-c839-409f-b436-8ad111227d09",
               "shirtNumber":"11"
            },
            {
               "fullName":"Dimitar  Tonev",
               "lastName":"Tonev",
               "firstName":"Dimitar ",
               "id":"a831e6ba-5783-46df-a51a-4522e7d6c2eb",
               "shirtNumber":"23"
            },
            {
               "fullName":"Roberto Puncec",
               "lastName":"Puncec",
               "firstName":"Roberto",
               "id":"d1f476f8-f17f-49a1-bf59-6def49a1745e",
               "shirtNumber":"44"
            },
            {
               "fullName":"Tochukwu  Nadi",
               "lastName":"Nadi",
               "firstName":"Tochukwu ",
               "id":"ca565d32-b89e-4eca-835a-eb5955a5a588",
               "shirtNumber":"21"
            },
            {
               "fullName":"Dylan  Mertens",
               "lastName":"Mertens",
               "firstName":"Dylan ",
               "id":"fe748c54-e038-41a6-9654-b9aafa90a66f",
               "shirtNumber":"6"
            },
            {
               "fullName":"Nikolay  Minkov",
               "lastName":"Minkov",
               "firstName":"Nikolay ",
               "id":"da7bad00-3340-4e3d-94f7-1664ee5cc6c8",
               "shirtNumber":"17"
            }
         ],
         "substitutes":[
            {
               "fullName":"Georgi  Argilashki",
               "lastName":"Argilashki",
               "firstName":"Georgi ",
               "id":"46564a3a-2894-4055-b466-acc997c7b3cc",
               "shirtNumber":"1"
            },
            {
               "fullName":"Biser  Bonev",
               "lastName":"Bonev",
               "firstName":"Biser ",
               "id":"6145d88e-fec2-48c4-bc0a-fb46c5c96436",
               "shirtNumber":"14"
            },
            {
               "fullName":"Lachezar  Baltanov",
               "lastName":"Baltanov",
               "firstName":"Lachezar ",
               "id":"ee56d6de-0cbd-4a0a-b5f9-2dd0b40e463f",
               "shirtNumber":"20"
            },
            {
               "fullName":"Hristiyan Slavkov",
               "lastName":"Slavkov",
               "firstName":"Hristiyan",
               "id":"27569b0b-27a8-4ddc-9a1d-209f7ef2ae6a",
               "shirtNumber":"84"
            },
            {
               "fullName":"Atanas Chernev",
               "lastName":"Chernev",
               "firstName":"Atanas",
               "id":"d1125214-0a83-46ea-809f-6095894437ab",
               "shirtNumber":"27"
            },
            {
               "fullName":"Monir Al-Bodarin",
               "lastName":"Al-Bodarin",
               "firstName":"Monir",
               "id":"5896e7e0-6550-4ef6-995e-a9e7bbc4cbac",
               "shirtNumber":"38"
            },
            {
               "fullName":"Samuel Akere",
               "lastName":"Akere",
               "firstName":"Samuel",
               "id":"4ffb8153-2280-4651-9617-78e5a0264123",
               "shirtNumber":"16"
            }
         ],
         "teamId":"aba100e8-a29a-4bc3-8f87-eb669b34c5a7"
      },
      "period":0
   },
   "fixtureSummary":{
      "awayTeamScore":0,
      "currentClockTime":"00:00",
      "periods":[
         
      ],
      "homeTeamScore":0,
      "isTied":true,
      "isHomeTeamInPossesion":false,
      "finished":false,
      "currentPeriod":1,
      "currentStatus":"LineUps"
   },
   "version":1
}

Attack

{
   "fixtureAction":{
      "timestamp":"2022-07-08T16:16:13.982988Z",
      "actionId":"2a7864ef-4079-421f-9429-e6913e7e46bc",
      "fixtureSeqNum":348,
      "clockTime":"45:27",
      "fixtureActionType":"Attack",
      "fixtureActionTypeId":102,
      "sendTypeId":5,
      "sendType":"Confirmed",
      "team":{
         "id":"aba100e8-a29a-4bc3-8f87-eb669b34c5a7",
         "name":"Botev Plovdiv"
      },
      "fixtureId":"4781718f-bba3-4e7b-a16f-1ccddf91c28d",
      "period":1
   },
   "fixtureSummary":{
      "awayTeamScore":0,
      "currentClockTime":"45:28",
      "periods":[
         {
            "awayTeamPeriodScore":0,
            "awayTeamScore":0,
            "label":"1st half",
            "id":1,
            "homeTeamScore":0,
            "end":null,
            "type":"Regular",
            "homeTeamPeriodScore":0,
            "start":"2022-07-08T15:30:45"
         }
      ],
      "homeTeamScore":0,
      "isTied":true,
      "isHomeTeamInPossesion":false,
      "finished":false,
      "currentPeriod":1,
      "currentStatus":"Live"
   },
   "version":1
}

Substitutions

Substitution Out - Confirmed
Substitution In - Confirmed

Substitution Out - Confirmed

{
   "fixtureAction":{
      "timestamp":"2022-07-08T19:48:24.407791Z",
      "actionId":"ae310f4a-4cfd-4ed7-98d6-26983d8ee2c5",
      "fixtureSeqNum":708,
      "clockTime":"85:52",
      "fixtureActionType":"Substitution Out",
      "player":{
         "id":"d07e6b12-9d60-468e-a889-64e65684117e",
         "name":"Atanas Kabov"
      },
      "fixtureActionTypeId":14,
      "sendTypeId":5,
      "sendType":"Confirmed",
      "team":{
         "id":"6e586fe0-ca11-491e-9b37-6897e098e9ed",
         "name":"Septemvri Sofia"
      },
      "fixtureId":"3ff2ab4d-e773-4ba2-a89b-7ad83fd180f6",
      "period":2
   },
   "fixtureSummary":{
      "awayTeamScore":3,
      "currentClockTime":"85:52",
      "periods":[
         {
            "awayTeamPeriodScore":1,
            "awayTeamScore":1,
            "label":"1st half",
            "id":1,
            "homeTeamScore":0,
            "end":"2022-07-08T18:52:14",
            "type":"Regular",
            "homeTeamPeriodScore":0,
            "start":"2022-07-08T18:03:08"
         },
         {
            "awayTeamPeriodScore":2,
            "awayTeamScore":3,
            "label":"2nd half",
            "id":2,
            "homeTeamScore":0,
            "end":null,
            "type":"Regular",
            "homeTeamPeriodScore":0,
            "start":"2022-07-08T19:07:31"
         }
      ],
      "homeTeamScore":0,
      "isTied":false,
      "isHomeTeamInPossesion":false,
      "finished":false,
      "currentPeriod":2,
      "currentStatus":"Live"
   },
   "version":1
}

Substitution In - Confirmed

{
   "fixtureAction":{
      "timestamp":"2022-07-08T19:48:24.407797Z",
      "actionId":"f382d83a-4b15-44be-8610-db60c5639b9a",
      "fixtureSeqNum":709,
      "clockTime":"85:52",
      "fixtureActionType":"Substitution In",
      "player":{
         "id":"71ab0479-d054-4895-820f-881896ac46b8",
         "name":""
      },
      "fixtureActionTypeId":13,
      "sendTypeId":5,
      "sendType":"Confirmed",
      "team":{
         "id":"6e586fe0-ca11-491e-9b37-6897e098e9ed",
         "name":"Septemvri Sofia"
      },
      "fixtureId":"3ff2ab4d-e773-4ba2-a89b-7ad83fd180f6",
      "period":2
   },
   "fixtureSummary":{
      "awayTeamScore":3,
      "currentClockTime":"85:53",
      "periods":[
         {
            "awayTeamPeriodScore":1,
            "awayTeamScore":1,
            "label":"1st half",
            "id":1,
            "homeTeamScore":0,
            "end":"2022-07-08T18:52:14",
            "type":"Regular",
            "homeTeamPeriodScore":0,
            "start":"2022-07-08T18:03:08"
         },
         {
            "awayTeamPeriodScore":2,
            "awayTeamScore":3,
            "label":"2nd half",
            "id":2,
            "homeTeamScore":0,
            "end":null,
            "type":"Regular",
            "homeTeamPeriodScore":0,
            "start":"2022-07-08T19:07:31"
         }
      ],
      "homeTeamScore":0,
      "isTied":false,
      "isHomeTeamInPossesion":false,
      "finished":false,
      "currentPeriod":2,
      "currentStatus":"Live"
   },
   "version":1
}

Fixtures

List all fixtures.

The Fixtures API lets developers list and manage season fixtures. This is a gateway into the Actions API.

Applications don't need any input to list all fixtures, however information can be filtered by start date and end date. The result is useful for obtaining competiton Ids, season Ids, and stage Ids.

Endpoints

List fixtures

GET https://dde-api.data.imgarena.com/{sport}/fixtures

Retrieves a list of seasons for a specific sport.

Path Parameters

Name

Type

Description

sport*

String

A unique name for the requested sport. Example: basketball, soccer, v2/volleyball, snooker

String

Query Parameters

Name

Type

Description

subscribed

Boolean

Lists the fixtures for which a user is licensed. Example: true, false

live

Boolean

Allows users to determine which fixtures are live and available based on a user's licence. Example: true, false

status

String

Allows clients to filter based on the status of a match or group of matches. Example: scheduled, live, completed, postponed

dateFrom

Date

DAllows clients to filter between specific dates. Example: 2023-01-01

dateTo

Date

Allows clients to filter between specific dates. Example: 2023-01-01

type

String

Allows clients to filter based on the type of a match or group of matches. Example: official, simulation, training

coverageLevel

String

Headers

Name

Type

Description

Accept*

String

application/vnd.imggaming.dde.api+json;version=1

Authorization*

String

Bearer ACCESS_TOKEN

Content-Type*

String

application/json

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

{
        "id": "2ffbf044-db53-43ea-9898-a43868ca014d",
        "name": "BC Lietkabelis Panevezys v Jonava BC Cbet",
        "status": "Scheduled",
        "type": "Official",
        "coverageLevel": "In Venue",
        "startDateUTC": "2023-01-07T15:00:00",
        "teams": [
            {
                "id": "f14fd931-a113-4a0b-9c5c-532057c96301",
                "name": "Jonava BC Cbet",
                "club": {
                    "id": "b6c236e8-b9df-4a65-ae01-932864572b93",
                    "name": "JONAVA BC CBET"
                },
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "homeTeam": false
            },
            {
                "id": "b184558c-d9dd-4ada-898d-520b3d387622",
                "name": "BC Lietkabelis Panevezys",
                "club": {
                    "id": "bda8ed69-da63-434e-8b79-a20980f32c2e",
                    "name": "BC LIETKABELIS PANEVEZYS"
                },
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "homeTeam": true
            }
        ],
        "stage": {
            "id": "96afe2dd-58e7-435d-a9f9-999d64ec8b86",
            "name": "Regular round",
            "season": {
                "id": "7ac2140e-dd57-404a-bc3a-54d7fcd97343",
                "name": "Season 2022/2023",
                "startDateUTC": "2022-09-24T12:00:00",
                "endDateUTC": "2023-05-31T12:00:00",
                "competition": {
                    "id": "5c50bf20-7b5e-4d19-b2fe-aa1d20a042b2",
                    "name": "Lithuania LKL",
                    "category": {
                        "id": 1,
                        "name": "Men"
                    },
                    "tour": {
                        "id": 45,
                        "name": "Lithuanian Basketball Federation (LKF)"
                    },
                    "location": {
                        "name": "Lithuania",
                        "country": {},
                        "continent": {
                            "name": "Europe"
                        }
                    }
                }
            },
            "startDateUTC": "2022-09-24T12:00:00",
            "endDateUTC": "2023-05-31T12:00:00"
        },
        "venue": {
            "id": "7d30af55-89e2-4b50-a107-db133dcb3730",
            "name": "Cido Arena",
            "location": {
                "name": "Panevezys",
                "country": {
                    "name": "Lithuania"
                },
                "continent": {
                    "name": "Europe"
                }
            }
        }
    }

List season fixtures

GET https://dde-api.data.imgarena.com/{sport}/seasons/{seasonId}/fixtures

Path Parameters

Name

Type

Description

sport*

String

A unique name for the requested sport. Example: basketball, soccer, v2/volleyball, snooker

seasonId*

UUID

unique id of a requested season

Query Parameters

Name

Type

Description

subscribed

Boolean

Lists the fixtures for which a user is licensed. Example: true, false

live

Boolean

Allows users to determine which fixtures are live and available based on a user's licence. Example: true, false

status

String

Allows clients to filter based on the status of a match or group of matches. Example: scheduled, live, completed, postponed

dateFrom

Date

Allows clients to filter between specific dates. Example: 2023-01-01

dateTo

Date

Allows clients to filter between specific dates. Example: 2023-01-01

type

String

Allows clients to filter based on the type of a match or group of matches. Example: official, simulation, training

{
        "id": "ffc47dc5-61e1-44e9-add7-6088c415aa42",
        "name": "Hapoel Tel Aviv v Ironi Kiryat Ata",
        "status": "Completed",
        "type": "Official",
        "coverageLevel": "In Venue",
        "startDateUTC": "2022-09-19T17:00:00",
        "teams": [
            {
                "id": "114aa40d-6895-48b9-9bfe-0abecc9d10c9",
                "name": "Hapoel Tel Aviv",
                "club": {
                    "id": "3bf65514-d1b3-4768-8119-cee69b574734",
                    "name": "HAPOEL TEL AVIV"
                },
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "homeTeam": true
            },
            {
                "id": "d4407cea-1880-4afa-8aa6-9c58b2d583f4",
                "name": "Ironi Kiryat Ata",
                "club": {
                    "id": "da2da316-8876-4939-873b-d4ce5bff3688",
                    "name": "IRONI KIRYAT ATA"
                },
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "homeTeam": false
            }
        ],
        "stage": {
            "id": "7eb6159c-94bf-45bd-a52d-4143fdbe47d0",
            "name": "Regular round",
            "season": {
                "id": "c7e3e6b7-e24f-4e76-8247-6d4626d17935",
                "name": "Season 2022/2023",
                "startDateUTC": "2022-09-19T12:00:00",
                "endDateUTC": "2023-05-31T12:00:00",
                "competition": {
                    "id": "7d6aeba6-2599-4231-a0f9-fd218f38bced",
                    "name": "Israel League Cup",
                    "category": {
                        "id": 1,
                        "name": "Men"
                    },
                    "tour": {
                        "id": 37,
                        "name": "Israeli Basketball Association (IBBA)"
                    },
                    "location": {
                        "name": "Israel",
                        "country": {},
                        "continent": {
                            "name": "Asia"
                        }
                    }
                }
            },
            "startDateUTC": "2022-11-01T12:00:00",
            "endDateUTC": "2023-05-31T12:00:00"
        },
        "venue": {
            "id": "665e9df6-4587-41b4-9a75-085e56e8579b",
            "name": "Drive in Arena",
            "location": {
                "name": "Tel Aviv",
                "country": {
                    "name": "Israel"
                },
                "continent": {
                    "name": "Asia"
                }
            }
        }
    }

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

Get fixture

GET https://dde-api.data.imgarena.com/{sport}/fixtures/{fixtureId}

Path Parameters

Name

Type

Description

sport*

String

A unique name for the requested sport. Example: basketball, soccer, v2/volleyball, snooker

fixtureId*

UUID

Unique id of a requested fixture.

{
    "id": "ffc47dc5-61e1-44e9-add7-6088c415aa42",
    "name": "Hapoel Tel Aviv v Ironi Kiryat Ata",
    "status": "Completed",
    "type": "Official",
    "coverageLevel": "In Venue",
    "startDateUTC": "2022-09-19T17:00:00",
    "teams": [
        {
            "id": "114aa40d-6895-48b9-9bfe-0abecc9d10c9",
            "name": "Hapoel Tel Aviv",
            "club": {
                "id": "3bf65514-d1b3-4768-8119-cee69b574734",
                "name": "HAPOEL TEL AVIV"
            },
            "category": {
                "id": 1,
                "name": "Men"
            },
            "homeTeam": true
        },
        {
            "id": "d4407cea-1880-4afa-8aa6-9c58b2d583f4",
            "name": "Ironi Kiryat Ata",
            "club": {
                "id": "da2da316-8876-4939-873b-d4ce5bff3688",
                "name": "IRONI KIRYAT ATA"
            },
            "category": {
                "id": 1,
                "name": "Men"
            },
            "homeTeam": false
        }
    ],
    "stage": {
        "id": "7eb6159c-94bf-45bd-a52d-4143fdbe47d0",
        "name": "Regular round",
        "season": {
            "id": "c7e3e6b7-e24f-4e76-8247-6d4626d17935",
            "name": "Season 2022/2023",
            "startDateUTC": "2022-09-19T12:00:00",
            "endDateUTC": "2023-05-31T12:00:00",
            "competition": {
                "id": "7d6aeba6-2599-4231-a0f9-fd218f38bced",
                "name": "Israel League Cup",
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "tour": {
                    "id": 37,
                    "name": "Israeli Basketball Association (IBBA)"
                },
                "location": {
                    "name": "Israel",
                    "country": {},
                    "continent": {
                        "name": "Asia"
                    }
                }
            }
        },
        "startDateUTC": "2022-11-01T12:00:00",
        "endDateUTC": "2023-05-31T12:00:00"
    },
    "venue": {
        "id": "665e9df6-4587-41b4-9a75-085e56e8579b",
        "name": "Drive in Arena",
        "location": {
            "name": "Tel Aviv",
            "country": {
                "name": "Israel"
            },
            "continent": {
                "name": "Asia"
            }
        }
    }
}

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

Response fields

The requested list of seasons

Fixture attributes

id (uuid) - The FastPath-assigned ID of the fixture
name (string) - Descriptive name of the fixture
startDateUTC (datetime) - Start date of the fixture
status (string) - Competition information within the season
type (string) - Round of match within a competition
coverageLevel (string) - Round of match within a competition
teams (Teams) - Round of match within a competition
stage (Stage) - Round of match within a competition
venue (Venue) - Round of match within a competition

Teams

id (uuid) - The FastPath-assigned ID of the competition within the season
name (string) - Name of the competition. Example: Israel League Cup
club (Club) - Competition category information
category (Category) - Competition category information
homeTeam (boolean) - Venue information of the competition

Club

name

Stage

id (uuid) -
name (string) -
season (Season) -
startDateUTC (datetime) -
endDateUTC (datetime) -
rounds (object) -
groups (object) -

Venue

id (string) - The FastPath-assigned id of the venue. Example: 665e9df6-4587-41b4-9a75-085e56e8579b
name (string) - Descriptive name of the venue. Example: Drive in Arena
location (Location) - Geographic location of the venue. Usually it is the city, country and continent. Example: Tel Aviv, Israel, Asia

Location

name (string) - Name of the venue. Example: Tel Aviv
country (Country) - List of countries where the fixture is played out. Example: Israel
continent (Continent) - List of continents where the fixture is played out. Example: Asia

Country

name (string) - Name of the country where the fixture plays out

Continent

name (string) - Name of the continent where the fixture plays out

Polling frequency

We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times - once per 12 hours

Match Stats

This REST API endpoint returns the final aggregated match stats packet in a single URL call (which are typically delivered in the 'Live match Statistics' websocket). These stats are delivered in the API call at the END of the fixture.

The data contained will include all team and player aggregated stats happening within the basketball match - this will include; goals, cards, corners, shots and more. For a list of all match stats that are supported, as well as definitions of these actions, please see the following documentation page.

https://docs.imgarena.com/basketball/stream-endpoints-websocket/live-match-statistics-box-score#definitions

Endpoint URL

https://dde-api.data.imgarena.com/basketball/fixtures/{fixtureId}/statistics

Polling Frequency

We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times:

REST Endpoint

Frequency

Description

/basketball/fixtures/{fixtureId}/statistics

Once post match

Updated at the end of each match with the full list of team and player match stats

Required Headers

Key

Value

application/vnd.imggaming.dde.api+json;version=1

Content-Type

application/json

Authorization

Bearer eyvhaoudfgpdfgo*

Response Model

Please see the live actions websocket 'Response Model' section to understand the stats, definitions. Below is also a small snippet of the JSON schema

{
    "seqNum": 1535,
    "version": 2,
    "finished": true,
    "fixtureId": "acf80323-ccb3-4828-a7dc-63f21b529b62",
    "timestamp": "2022-11-06T13:17:07.082050100Z",
    "teamActionAggregates": [
        {
            "team": {
                "id": "02ed1f32-385f-4e0f-b78f-390a498d34af",
                "name": "Rudar"
            },
            "gameActionAggregates": [
                {
                    "action": "3PT Shot",
                    "actionId": 233,
                    "actionAggregate": 28,
                    "subActionAggregates": []
                },
                {
                    "action": "3PT missed",
                    "actionId": 211,
                    "actionAggregate": 24,
                    "subActionAggregates": []
                },
                {
                    "action": "Offensive Rebound",
                    "actionId": 204,
                    "actionAggregate": 11,
                    "subActionAggregates": []
                },
                {
                    "action": "FT missed",
                    "actionId": 209,
                    "actionAggregate": 11,
                    "subActionAggregates": []
                },
                {
                    "action": "Foul Against",
                    "actionId": 230,
                    "actionAggregate": 15,
                    "subActionAggregates": []
                },
                {
                    "action": "FT awarded",
                    "actionId": 213,
                    "actionAggregate": 12,
                    "subActionAggregates": [
                        {
                            "subAction": "1FT",
                            "subActionId": 21301,
                            "subActionAggregate": 3
                        },
                        {
                            "subAction": "2FT",
                            "subActionId": 21302,
                            "subActionAggregate": 9
                        }
                    ]
                },
                {
                    "action": "2PT Shot",
                    "actionId": 232,
                    "actionAggregate": 38,
                    "subActionAggregates": []
                },
                {
                    "action": "2PT made",
                    "actionId": 207,
                    "actionAggregate": 22,
                    "subActionAggregates": []
                },
                {
                    "action": "2PT missed",
                    "actionId": 210,
                    "actionAggregate": 16,
                    "subActionAggregates": []
                },
                {
                    "action": "FT made",
                    "actionId": 206,
                    "actionAggregate": 10,
                    "subActionAggregates": []
                },
                {
                    "action": "Defensive Rebound",
                    "actionId": 205,
                    "actionAggregate": 25,
                    "subActionAggregates": []
                },
                {
                    "action": "Block",
                    "actionId": 223,
                    "actionAggregate": 4,
                    "subActionAggregates": []
                },
                {
                    "action": "Steal",
                    "actionId": 222,
                    "actionAggregate": 13,
                    "subActionAggregates": []
                },
                {
                    "action": "Player Foul",
                    "actionId": 212,
                    "actionAggregate": 21,
                    "subActionAggregates": [
                        {
                            "subAction": "Personal",
                            "subActionId": 21201,
                            "subActionAggregate": 18
                        },
                        {
                            "subAction": "Offensive",
                            "subActionId": 21204,
                            "subActionAggregate": 2
                        },
                        {
                            "subAction": "Unsportsmanlike",
                            "subActionId": 21203,
                            "subActionAggregate": 1
                        }
                    ]
                },
                {
                    "action": "Turnover",
                    "actionId": 201,
                    "actionAggregate": 20,
                    "subActionAggregates": [
                        {
                            "subAction": "Double Dribble",
                            "subActionId": 20005,
                            "subActionAggregate": 3
                        },
                        {
                            "subAction": "Stolen",
                            "subActionId": 20001,
                            "subActionAggregate": 12
                        },
                        {
                            "subAction": "Travelling",
                            "subActionId": 20004,
                            "subActionAggregate": 2
                        },
                        {
                            "subAction": "Back Court Violation",
                            "subActionId": 20003,
                            "subActionAggregate": 3
                        }
                    ]
                },
                {
                    "action": "Defensive Team Rebound",
                    "actionId": 225,
                    "actionAggregate": 2,
                    "subActionAggregates": []
                },
                {
                    "action": "Assist",
                    "actionId": 217,
                    "actionAggregate": 16,
                    "subActionAggregates": []
                },
                {
                    "action": "3PT made",
                    "actionId": 208,
                    "actionAggregate": 4,
                    "subActionAggregates": []
                }
            ],
            "periodActionAggregates": [
                {
                    "period": 1,
                    "aggregates": [
                        {
                            "action": "3PT Shot",
                            "actionId": 233,
                            "actionAggregate": 7,
                            "subActionAggregates": []
                        },
                        {
                            "action": "3PT missed",
                            "actionId": 211,
                            "actionAggregate": 7,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Offensive Rebound",
                            "actionId": 204,
                            "actionAggregate": 5,
                            "subActionAggregates": []
                        },
                        {
                            "action": "FT missed",
                            "actionId": 209,
                            "actionAggregate": 4,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Foul Against",
                            "actionId": 230,
                            "actionAggregate": 4,
                            "subActionAggregates": []
                        },
                        {
                            "action": "FT awarded",
                            "actionId": 213,
                            "actionAggregate": 4,
                            "subActionAggregates": [
                                {
                                    "subAction": "1FT",
                                    "subActionId": 21301,
                                    "subActionAggregate": 2
                                },
                                {
                                    "subAction": "2FT",
                                    "subActionId": 21302,
                                    "subActionAggregate": 2
                                }
                            ]
                        },
                        {
                            "action": "2PT Shot",
                            "actionId": 232,
                            "actionAggregate": 13,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT made",
                            "actionId": 207,
                            "actionAggregate": 7,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT missed",
                            "actionId": 210,
                            "actionAggregate": 6,
                            "subActionAggregates": []
                        },
                        {
                            "action": "FT made",
                            "actionId": 206,
                            "actionAggregate": 2,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Defensive Rebound",
                            "actionId": 205,
                            "actionAggregate": 4,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Block",
                            "actionId": 223,
                            "actionAggregate": 1,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Steal",
                            "actionId": 222,
                            "actionAggregate": 5,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Player Foul",
                            "actionId": 212,
                            "actionAggregate": 4,
                            "subActionAggregates": [
                                {
                                    "subAction": "Personal",
                                    "subActionId": 21201,
                                    "subActionAggregate": 3
                                },
                                {
                                    "subAction": "Offensive",
                                    "subActionId": 21204,
                                    "subActionAggregate": 1
                                }
                            ]
                        },
                        {
                            "action": "Turnover",
                            "actionId": 201,
                            "actionAggregate": 4,
                            "subActionAggregates": [
                                {
                                    "subAction": "Double Dribble",
                                    "subActionId": 20005,
                                    "subActionAggregate": 2
                                },
                                {
                                    "subAction": "Stolen",
                                    "subActionId": 20001,
                                    "subActionAggregate": 2
                                }
                            ]
                        },
                        {
                            "action": "Defensive Team Rebound",
                            "actionId": 225,
                            "actionAggregate": 1,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Assist",
                            "actionId": 217,
                            "actionAggregate": 2,
                            "subActionAggregates": []
                        }
                    ]
                },
                {
                    "period": 2,
                    "aggregates": [
                        {
                            "action": "Player Foul",
                            "actionId": 212,
                            "actionAggregate": 10,
                            "subActionAggregates": [
                                {
                                    "subAction": "Personal",
                                    "subActionId": 21201,
                                    "subActionAggregate": 8
                                },
                                {
                                    "subAction": "Offensive",
                                    "subActionId": 21204,
                                    "subActionAggregate": 1
                                },
                                {
                                    "subAction": "Unsportsmanlike",
                                    "subActionId": 21203,
                                    "subActionAggregate": 1
                                }
                            ]
                        },
                        {
                            "action": "3PT Shot",
                            "actionId": 233,
                            "actionAggregate": 5,
                            "subActionAggregates": []
                        },
                        {
                            "action": "3PT missed",
                            "actionId": 211,
                            "actionAggregate": 5,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Defensive Rebound",
                            "actionId": 205,
                            "actionAggregate": 12,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Turnover",
                            "actionId": 201,
                            "actionAggregate": 8,
                            "subActionAggregates": [
                                {
                                    "subAction": "Travelling",
                                    "subActionId": 20004,
                                    "subActionAggregate": 2
                                },
                                {
                                    "subAction": "Stolen",
                                    "subActionId": 20001,
                                    "subActionAggregate": 3
                                },
                                {
                                    "subAction": "Back Court Violation",
                                    "subActionId": 20003,
                                    "subActionAggregate": 2
                                },
                                {
                                    "subAction": "Double Dribble",
                                    "subActionId": 20005,
                                    "subActionAggregate": 1
                                }
                            ]
                        },
                        {
                            "action": "2PT Shot",
                            "actionId": 232,
                            "actionAggregate": 11,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT made",
                            "actionId": 207,
                            "actionAggregate": 8,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Assist",
                            "actionId": 217,
                            "actionAggregate": 7,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Foul Against",
                            "actionId": 230,
                            "actionAggregate": 4,
                            "subActionAggregates": []
                        },
                        {
                            "action": "FT awarded",
                            "actionId": 213,
                            "actionAggregate": 3,
                            "subActionAggregates": [
                                {
                                    "subAction": "1FT",
                                    "subActionId": 21301,
                                    "subActionAggregate": 1
                                },
                                {
                                    "subAction": "2FT",
                                    "subActionId": 21302,
                                    "subActionAggregate": 2
                                }
                            ]
                        },
                        {
                            "action": "FT made",
                            "actionId": 206,
                            "actionAggregate": 3,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Block",
                            "actionId": 223,
                            "actionAggregate": 1,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Steal",
                            "actionId": 222,
                            "actionAggregate": 3,
                            "subActionAggregates": []
                        },
                        {
                            "action": "FT missed",
                            "actionId": 209,
                            "actionAggregate": 2,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT missed",
                            "actionId": 210,
                            "actionAggregate": 3,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Offensive Rebound",
                            "actionId": 204,
                            "actionAggregate": 5,
                            "subActionAggregates": []
                        }
                    ]
                },
                {
                    "period": 3,
                    "aggregates": [
                        {
                            "action": "3PT Shot",
                            "actionId": 233,
                            "actionAggregate": 9,
                            "subActionAggregates": []
                        },
                        {
                            "action": "3PT missed",
                            "actionId": 211,
                            "actionAggregate": 6,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Steal",
                            "actionId": 222,
                            "actionAggregate": 3,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT Shot",
                            "actionId": 232,
                            "actionAggregate": 6,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT made",
                            "actionId": 207,
                            "actionAggregate": 3,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Assist",
                            "actionId": 217,
                            "actionAggregate": 5,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Player Foul",
                            "actionId": 212,
                            "actionAggregate": 4,
                            "subActionAggregates": [
                                {
                                    "subAction": "Personal",
                                    "subActionId": 21201,
                                    "subActionAggregate": 4
                                }
                            ]
                        },
                        {
                            "action": "Defensive Rebound",
                            "actionId": 205,
                            "actionAggregate": 5,
                            "subActionAggregates": []
                        },
                        {
                            "action": "3PT made",
                            "actionId": 208,
                            "actionAggregate": 3,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Foul Against",
                            "actionId": 230,
                            "actionAggregate": 4,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT missed",
                            "actionId": 210,
                            "actionAggregate": 3,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Turnover",
                            "actionId": 201,
                            "actionAggregate": 5,
                            "subActionAggregates": [
                                {
                                    "subAction": "Stolen",
                                    "subActionId": 20001,
                                    "subActionAggregate": 4
                                },
                                {
                                    "subAction": "Back Court Violation",
                                    "subActionId": 20003,
                                    "subActionAggregate": 1
                                }
                            ]
                        },
                        {
                            "action": "Block",
                            "actionId": 223,
                            "actionAggregate": 2,
                            "subActionAggregates": []
                        },
                        {
                            "action": "FT awarded",
                            "actionId": 213,
                            "actionAggregate": 2,
                            "subActionAggregates": [
                                {
                                    "subAction": "2FT",
                                    "subActionId": 21302,
                                    "subActionAggregate": 2
                                }
                            ]
                        },
                        {
                            "action": "FT made",
                            "actionId": 206,
                            "actionAggregate": 2,
                            "subActionAggregates": []
                        },
                        {
                            "action": "FT missed",
                            "actionId": 209,
                            "actionAggregate": 2,
                            "subActionAggregates": []
                        }
                    ]
                },
                {
                    "period": 4,
                    "aggregates": [
                        {
                            "action": "Turnover",
                            "actionId": 201,
                            "actionAggregate": 3,
                            "subActionAggregates": [
                                {
                                    "subAction": "Stolen",
                                    "subActionId": 20001,
                                    "subActionAggregate": 3
                                }
                            ]
                        },
                        {
                            "action": "3PT Shot",
                            "actionId": 233,
                            "actionAggregate": 7,
                            "subActionAggregates": []
                        },
                        {
                            "action": "3PT missed",
                            "actionId": 211,
                            "actionAggregate": 6,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Defensive Team Rebound",
                            "actionId": 225,
                            "actionAggregate": 1,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT Shot",
                            "actionId": 232,
                            "actionAggregate": 8,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT made",
                            "actionId": 207,
                            "actionAggregate": 4,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Steal",
                            "actionId": 222,
                            "actionAggregate": 2,
                            "subActionAggregates": []
                        },
                        {
                            "action": "3PT made",
                            "actionId": 208,
                            "actionAggregate": 1,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Assist",
                            "actionId": 217,
                            "actionAggregate": 2,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Foul Against",
                            "actionId": 230,
                            "actionAggregate": 3,
                            "subActionAggregates": []
                        },
                        {
                            "action": "FT awarded",
                            "actionId": 213,
                            "actionAggregate": 3,
                            "subActionAggregates": [
                                {
                                    "subAction": "2FT",
                                    "subActionId": 21302,
                                    "subActionAggregate": 3
                                }
                            ]
                        },
                        {
                            "action": "FT missed",
                            "actionId": 209,
                            "actionAggregate": 3,
                            "subActionAggregates": []
                        },
                        {
                            "action": "FT made",
                            "actionId": 206,
                            "actionAggregate": 3,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT missed",
                            "actionId": 210,
                            "actionAggregate": 4,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Player Foul",
                            "actionId": 212,
                            "actionAggregate": 3,
                            "subActionAggregates": [
                                {
                                    "subAction": "Personal",
                                    "subActionId": 21201,
                                    "subActionAggregate": 3
                                }
                            ]
                        },
                        {
                            "action": "Offensive Rebound",
                            "actionId": 204,
                            "actionAggregate": 1,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Defensive Rebound",
                            "actionId": 205,
                            "actionAggregate": 4,
                            "subActionAggregates": []
                        }
                    ]
                }
            ],
            "playerActionAggregates": [
                {
                    "player": {
                        "id": "4b6fe5e8-5f0a-4f59-bdef-f5ff54bce28d",
                        "name": "Dejan Dzakovic"
                    },
                    "gameActionAggregates": [
                        {
                            "action": "3PT Shot",
                            "actionId": 233,
                            "actionAggregate": 8,
                            "subActionAggregates": []
                        },
                        {
                            "action": "3PT missed",
                            "actionId": 211,
                            "actionAggregate": 8,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Defensive Rebound",
                            "actionId": 205,
                            "actionAggregate": 7,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Steal",
                            "actionId": 222,
                            "actionAggregate": 5,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Foul Against",
                            "actionId": 230,
                            "actionAggregate": 4,
                            "subActionAggregates": []
                        },
                        {
                            "action": "FT awarded",
                            "actionId": 213,
                            "actionAggregate": 4,
                            "subActionAggregates": [
                                {
                                    "subAction": "2FT",
                                    "subActionId": 21302,
                                    "subActionAggregate": 4
                                }
                            ]
                        },
                        {
                            "action": "FT missed",
                            "actionId": 209,
                            "actionAggregate": 4,
                            "subActionAggregates": []
                        },
                        {
                            "action": "FT made",
                            "actionId": 206,
                            "actionAggregate": 4,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT Shot",
                            "actionId": 232,
                            "actionAggregate": 7,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT made",
                            "actionId": 207,
                            "actionAggregate": 5,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Offensive Rebound",
                            "actionId": 204,
                            "actionAggregate": 3,
                            "subActionAggregates": []
                        },
                        {
                            "action": "2PT missed",
                            "actionId": 210,
                            "actionAggregate": 2,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Turnover",
                            "actionId": 201,
                            "actionAggregate": 10,
                            "subActionAggregates": [
                                {
                                    "subAction": "Stolen",
                                    "subActionId": 20001,
                                    "subActionAggregate": 7
                                },
                                {
                                    "subAction": "Back Court Violation",
                                    "subActionId": 20003,
                                    "subActionAggregate": 2
                                },
                                {
                                    "subAction": "Double Dribble",
                                    "subActionId": 20005,
                                    "subActionAggregate": 1
                                }
                            ]
                        },
                        {
                            "action": "Assist",
                            "actionId": 217,
                            "actionAggregate": 7,
                            "subActionAggregates": []
                        },
                        {
                            "action": "Player Foul",
                            "actionId": 212,
                            "actionAggregate": 5,
                            "subActionAggregates": [
                                {
                                    "subAction": "Personal",
                                    "subActionId": 21201,
                                    "subActionAggregate": 4
                                },
                                {
                                    "subAction": "Offensive",
                                    "subActionId": 21204,
                                    "subActionAggregate": 1
                                }
                            ]
                        },
                        {
                            "action": "Block",
                            "actionId": 223,
                            "actionAggregate": 2,
                            "subActionAggregates": []
                        }
                    ],
                    "periodActionAggregates": [
                        {
                            "period": 1,
                            "aggregates": [
                                {
                                    "action": "3PT Shot",
                                    "actionId": 233,
                                    "actionAggregate": 3,
                                    "subActionAggregates": []
                                },
                                {
                                    "action": "3PT missed",
                                    "actionId": 211,
                                    "actionAggregate": 3,
                                    "subActionAggregates": []
                                },
                                {
                                    "action": "Defensive Rebound",
                                    "actionId": 205,
                                    "actionAggregate": 2,
                                    "subActionAggregates": []
                                },
                                {
                                    "action": "Steal",
                                    "actionId": 222,
                                    "actionAggregate": 2,
                                    "subActionAggregates": []
                                },
                                {
                                    "action": "Foul Against",
                                    "actionId": 230,
                                    "actionAggregate": 1,
                                    "subActionAggregates": []
                                },
                                {
                                    "action": "FT awarded",
                                    "actionId": 213,
                                    "actionAggregate": 1,
                                    "subActionAggregates": [
                                        {
                                            "subAction": "2FT",
                                            "subActionId": 21302,
                                            "subActionAggregate": 1
                                        }
                                    ]
                                },
                                {
                                    "action": "FT missed",
                                    "actionId": 209,
                                    "actionAggregate": 1,
                                    "subActionAggregates": []
                                },
                                {
                                    "action": "FT made",
                                    "actionId": 206,
                                    "actionAggregate": 1,
                                    "subActionAggregates": []
                                },
                                {
                                    "action": "2PT Shot",
                                    "actionId": 232,
                                    "actionAggregate": 3,
                                    "subActionAggregates": []
                                },
                                {
                                    "action": "2PT made",
                                    "actionId": 207,
                                    "actionAggregate": 1,
                                    "subActionAggregates": []
                                },
                                {
                                    "action": "Offensive Rebound",
                                    "actionId": 204,
                                    "actionAggregate": 3,
                                    "subActionAggregates": []
                                },
                                {
                                    "action": "2PT missed",
                                    "actionId": 210,
                                    "actionAggregate": 2,
                                    "subActionAggregates": []
                                },
                                {
                                    "action": "Turnover",
                                    "actionId": 201,
                                    "actionAggregate": 1,
                                    "subActionAggregates": [
                                        {
                                            "subAction": "Stolen",
                                            "subActionId": 20001,
                                            "subActionAggregate": 1
                                        }
                                    ]
                                },
                                {
                                    "action": "Assist",
                                    "actionId": 217,
                                    "actionAggregate": 2,
                                    "subActionAggregates": []
                                }

Basketball - Media

Basketball on the DDE

Polling limits

APIs

Websockets

Schedule API

Seasons

Endpoints

List seasons

Path Parameters

Query Parameters

Headers

Response fields

Season attributes

Competition

Category

Tour

Location

Continent

Stages

Polling frequency

Fixtures

Endpoints

List fixtures

Path Parameters

Query Parameters

Headers

List season fixtures

Path Parameters

Query Parameters

Get fixture

Path Parameters

Response fields

Fixture attributes

Teams

Club

Stage

Category

Venue

Location

Country

Continent

Polling frequency

Fixtures (old)

Endpoint URLs

Live Fixtures (Subscribed):

Fixtures (Subscribed):

All Fixtures (Unsubscribed):

Single Fixture

Status & dateTo and dateFrom

Type

Polling Frequency

Required Headers

Response Model

Squads

Endpoint URLs

Squads

Polling Frequency

Required Headers

Response Model

Actions

Endpoint URL

Polling Frequency

Required Headers

Response Model

Stream Endpoints (Websocket)

Live Actions

Endpoint URL

Headers

Process for connecting to the web socket endpoints

Request parameters

Polling limits

Response Model

Action Types

Response Model

Periods Object

Fixture Action Object

Live Match Statistics - Box Score

Endpoint URL

Polling limits