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.

Stream Endpoints (Websocket)

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
/basketball/fixtures/{fixtureId}/actions	Once post match	Updated at the end of each match with the full list of match actions

Required Headers

Key	Value
Accept	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 actions, definitions. Below is also a small snippet of the JSON schema.

Live Actions Response Model

[
    {
        "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"
        }