# Actions The Actions API lets developers list and manage player actions. It 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 a match. ## Endpoints ## List all player actions within a specific fixture `GET` `https://dde-api.data.imgarena.com/v2/tabletennis/fixtures/{fixtureId}/actions` Retrieves a list of player actions #### Path Parameters | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------- | | sport\* | string | tabletennis | | fixtureId\* | string | unique id of a requested fixture | #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------------------------------------ | | Accept\* | string | application/vnd.imggaming.dde.api+json;version=1 | | Authorization\* | string | Bearer ACCESS\_TOKEN | | Content-Type\* | string | application/json | {% tabs %} {% tab title="400: Bad Request " %} ```json { Request is missing required HTTP header 'Accept' } ``` {% endtab %} {% tab title="401: Unauthorized " %} ```json { The supplied authentication is invalid } ``` {% endtab %} {% tab title="200: OK " %} ```json { "traceId": "16c8bf0541f256b462c409f86e960d1c", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "353b35e6-4e24-4e58-900d-2f89968dc439", "name": "PARK Gahyeon", "homeTeam": true }, "period": 0, "actionId": "8a57b9c5-f3ef-4509-a831-64a3efd42932", "metadata": { "teamId": "353b35e6-4e24-4e58-900d-2f89968dc439", "substitutes": [], "startingLineup": [] }, "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:25:59.674Z", "sendTypeId": 5, "fixtureSeqNum": 1, "timelineSequence": 0.0000000000000001, "fixtureActionType": "Lineups", "fixtureActionTypeId": 3, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Scheduled", "homeTeamScore": 0, "collectionStatus": "CollectionScheduled", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": true } }, { "traceId": "cd70c91976aca7a4b5c2ad86c7efd348", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "ec5810e8-75f6-46b7-92e3-ac65fb151283", "name": "BATRA Manika", "homeTeam": false }, "period": 0, "actionId": "5fec9da3-5a52-4ba9-9906-ffdf1b1fc4e7", "metadata": { "teamId": "ec5810e8-75f6-46b7-92e3-ac65fb151283", "substitutes": [], "startingLineup": [] }, "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:25:59.674Z", "sendTypeId": 5, "fixtureSeqNum": 2, "timelineSequence": 0.0000000000000002, "fixtureActionType": "Lineups", "fixtureActionTypeId": 3, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Scheduled", "homeTeamScore": 0, "collectionStatus": "CollectionScheduled", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": true } }, { "traceId": "6a2484cb598f7770b252fc52d81c20d3", "version": 3, "finished": false, "fixtureAction": { "period": 0, "actionId": "5a001f1c-8eb3-431f-91c8-e1ebba008690", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:25:59.674Z", "sendTypeId": 5, "fixtureSeqNum": 3, "timelineSequence": 0.0000000000000003, "fixtureActionType": "Players Ready", "fixtureActionTypeId": 24, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Scheduled", "homeTeamScore": 0, "collectionStatus": "CollectionScheduled", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": true } }, { "traceId": "85860596875238217cb49fe6e87415c9", "version": 3, "finished": false, "fixtureAction": { "period": 1, "actionId": "aa149758-9548-4d11-aa7f-315718ab51bc", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:30:00.987Z", "sendTypeId": 5, "fixtureSeqNum": 4, "timelineSequence": 1.0000000000000004, "fixtureActionType": "Start Fixture", "fixtureActionTypeId": 4, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": true } }, { "traceId": "0ada24d0fe4e4c4a91ecd2810be29f55", "version": 3, "finished": false, "fixtureAction": { "period": 1, "actionId": "17e792aa-937e-4be8-8c92-41dcc35ae522", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:30:00.987Z", "sendTypeId": 5, "fixtureSeqNum": 5, "timelineSequence": 1.0000000000000005, "fixtureActionType": "Start Period", "fixtureActionTypeId": 6, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [ { "id": 1, "end": null, "type": "Regular", "label": "1st Set", "start": "2025-05-20T08:30:00", "awayTeamScore": 0, "homeTeamScore": 0, "awayTeamPeriodScore": 0, "homeTeamPeriodScore": 0 } ], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": true } }, { "traceId": "e683d476b9992798654a8b460f694e4d", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "353b35e6-4e24-4e58-900d-2f89968dc439", "name": "PARK Gahyeon", "homeTeam": true }, "period": 1, "actionId": "36d9df6f-4e8b-478d-8adc-ada82b0ac149", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:30:24.664Z", "sendTypeId": 5, "fixtureSeqNum": 6, "timelineSequence": 1.0000000000000006, "fixtureActionType": "Point Started", "fixtureActionTypeId": 1101, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [ { "id": 1, "end": null, "type": "Regular", "label": "1st Set", "start": "2025-05-20T08:30:00", "awayTeamScore": 0, "homeTeamScore": 0, "awayTeamPeriodScore": 0, "homeTeamPeriodScore": 0 } ], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": true } }, { "traceId": "f10d0617c0456cf319ce00eed962e0a2", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "353b35e6-4e24-4e58-900d-2f89968dc439", "name": "PARK Gahyeon", "homeTeam": true }, "period": 1, "actionId": "fc30beae-8934-4094-9e2d-d8d90f18f4ec", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:30:30.054Z", "sendTypeId": 5, "fixtureSeqNum": 7, "timelineSequence": 1.0000000000000007, "fixtureActionType": "Point Scored", "fixtureActionTypeId": 1102, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [ { "id": 1, "end": null, "type": "Regular", "label": "1st Set", "start": "2025-05-20T08:30:00", "awayTeamScore": 0, "homeTeamScore": 0, "awayTeamPeriodScore": 0, "homeTeamPeriodScore": 1 } ], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": true } }, { "traceId": "1014168b20f6ba4b562cd85779f43c17", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "353b35e6-4e24-4e58-900d-2f89968dc439", "name": "PARK Gahyeon", "homeTeam": true }, "period": 1, "actionId": "d3b73017-997a-43af-96a6-029a05436533", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:30:41.241Z", "sendTypeId": 5, "fixtureSeqNum": 8, "timelineSequence": 1.0000000000000008, "fixtureActionType": "Point Started", "fixtureActionTypeId": 1101, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [ { "id": 1, "end": null, "type": "Regular", "label": "1st Set", "start": "2025-05-20T08:30:00", "awayTeamScore": 0, "homeTeamScore": 0, "awayTeamPeriodScore": 0, "homeTeamPeriodScore": 1 } ], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": true } }, { "traceId": "7d5a8f83c821758f627ac8edae95ea42", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "353b35e6-4e24-4e58-900d-2f89968dc439", "name": "PARK Gahyeon", "homeTeam": true }, "period": 1, "actionId": "fd1cf04c-6a00-4227-a57b-a9ec302ffe84", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:30:48.476Z", "sendTypeId": 5, "fixtureSeqNum": 9, "timelineSequence": 1.0000000000000009, "fixtureActionType": "Point Scored", "fixtureActionTypeId": 1102, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [ { "id": 1, "end": null, "type": "Regular", "label": "1st Set", "start": "2025-05-20T08:30:00", "awayTeamScore": 0, "homeTeamScore": 0, "awayTeamPeriodScore": 0, "homeTeamPeriodScore": 2 } ], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": true } }, { "traceId": "48097edd89fa3ab1038eba96d0c038b3", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "ec5810e8-75f6-46b7-92e3-ac65fb151283", "name": "BATRA Manika", "homeTeam": false }, "period": 1, "actionId": "1135e035-e2a1-4175-b679-5baae3a6278d", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:30:48.476Z", "sendTypeId": 5, "fixtureSeqNum": 10, "timelineSequence": 1.0000000000000010, "fixtureActionType": "Swap Serve", "fixtureActionTypeId": 1103, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [ { "id": 1, "end": null, "type": "Regular", "label": "1st Set", "start": "2025-05-20T08:30:00", "awayTeamScore": 0, "homeTeamScore": 0, "awayTeamPeriodScore": 0, "homeTeamPeriodScore": 2 } ], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": false } }, { "traceId": "113ef76d008893c4629fd44257327382", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "ec5810e8-75f6-46b7-92e3-ac65fb151283", "name": "BATRA Manika", "homeTeam": false }, "period": 1, "actionId": "1a3566d1-eebc-4ffb-a020-2651e4b11247", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:31:06.653Z", "sendTypeId": 5, "fixtureSeqNum": 11, "timelineSequence": 1.0000000000000011, "fixtureActionType": "Point Started", "fixtureActionTypeId": 1101, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [ { "id": 1, "end": null, "type": "Regular", "label": "1st Set", "start": "2025-05-20T08:30:00", "awayTeamScore": 0, "homeTeamScore": 0, "awayTeamPeriodScore": 0, "homeTeamPeriodScore": 2 } ], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": false } }, { "traceId": "eeddee2848136759f028e1eabd83e341", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "353b35e6-4e24-4e58-900d-2f89968dc439", "name": "PARK Gahyeon", "homeTeam": true }, "period": 1, "actionId": "aecabdc3-a2a4-4dcc-9459-108b0997cfbf", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:31:14.878Z", "sendTypeId": 5, "fixtureSeqNum": 12, "timelineSequence": 1.0000000000000012, "fixtureActionType": "Point Scored", "fixtureActionTypeId": 1102, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [ { "id": 1, "end": null, "type": "Regular", "label": "1st Set", "start": "2025-05-20T08:30:00", "awayTeamScore": 0, "homeTeamScore": 0, "awayTeamPeriodScore": 0, "homeTeamPeriodScore": 3 } ], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": false } }, { "traceId": "3b7ef0367bb7bbf746e72e6d79f43345", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "ec5810e8-75f6-46b7-92e3-ac65fb151283", "name": "BATRA Manika", "homeTeam": false }, "period": 1, "actionId": "08b9ff9c-eecc-42bb-a61d-433668550243", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:31:27.659Z", "sendTypeId": 5, "fixtureSeqNum": 13, "timelineSequence": 1.0000000000000013, "fixtureActionType": "Point Started", "fixtureActionTypeId": 1101, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [ { "id": 1, "end": null, "type": "Regular", "label": "1st Set", "start": "2025-05-20T08:30:00", "awayTeamScore": 0, "homeTeamScore": 0, "awayTeamPeriodScore": 0, "homeTeamPeriodScore": 3 } ], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": false } }, { "traceId": "5f218ff4d1a87e6319d4889a03f8c494", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "ec5810e8-75f6-46b7-92e3-ac65fb151283", "name": "BATRA Manika", "homeTeam": false }, "period": 1, "actionId": "9963c592-689e-4b85-82b1-c9f42a8c5ea6", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:31:32.082Z", "sendTypeId": 5, "fixtureSeqNum": 14, "timelineSequence": 1.0000000000000014, "fixtureActionType": "Point Scored", "fixtureActionTypeId": 1102, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [ { "id": 1, "end": null, "type": "Regular", "label": "1st Set", "start": "2025-05-20T08:30:00", "awayTeamScore": 0, "homeTeamScore": 0, "awayTeamPeriodScore": 1, "homeTeamPeriodScore": 3 } ], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": false } }, { "traceId": "9f09ce3db7a0c2e3d4b5cef9bece5504", "version": 3, "finished": false, "fixtureAction": { "team": { "id": "353b35e6-4e24-4e58-900d-2f89968dc439", "name": "PARK Gahyeon", "homeTeam": true }, "period": 1, "actionId": "c0be0884-f660-4f3c-8d5b-f69ea8318c7e", "sendType": "Confirmed", "clockTime": "00:00", "fixtureId": "7c2253bb-790d-4cc5-9874-afa75d771e14", "timestamp": "2025-05-20T08:31:32.082Z", "sendTypeId": 5, "fixtureSeqNum": 15, "timelineSequence": 1.0000000000000015, "fixtureActionType": "Swap Serve", "fixtureActionTypeId": 1103, "relatedFixtureActionIds": [] }, "fixtureSummary": { "isTied": true, "periods": [ { "id": 1, "end": null, "type": "Regular", "label": "1st Set", "start": "2025-05-20T08:30:00", "awayTeamScore": 0, "homeTeamScore": 0, "awayTeamPeriodScore": 1, "homeTeamPeriodScore": 3 } ], "finished": false, "awayTeamScore": 0, "currentPeriod": 1, "currentStatus": "Live", "homeTeamScore": 0, "collectionStatus": "CollectingLive", "currentClockTime": "00:00", "currentClockState": "stopped", "isHomeTeamInPossesion": true } }, { ``` {% endtab %} {% endtabs %} ## Response Fields
PropertyDescription
actions
Action		The requested list of actions.
## 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 post match.`