List play-by-play events
Every tagged event in match order, with the match sheet used to attribute them. Use the box score if you only need totals.
Authorization
apiKey Club API key, for example ss_live_…. Create one in the Superstat app under Settings → API keys.
In: header
Path Parameters
Match id.
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/matches/497f6eca-6276-4993-bfeb-53cbbbba6f08/events"{ "data": { "roster": [ { "rosterEntryId": "a7b8c9d0-e1f2-4a3b-8c45-6e7f80910213", "playerId": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102", "firstName": "Ava", "lastName": "Nguyen", "jerseyNumber": "7", "side": "team" } ], "events": [ { "id": "d0e1f2a3-b4c5-4d6e-8f78-91021324a5b6", "type": "three_point", "success": true, "side": "team", "matchSeconds": 1432.5, "periodId": "c9d0e1f2-a3b4-4c5d-9e67-8091021324a5", "periodNumber": 2, "periodType": "quarter", "periodSeconds": 232.5, "player": { "id": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102", "rosterEntryId": "a7b8c9d0-e1f2-4a3b-8c45-6e7f80910213", "name": "Ava Nguyen", "jerseyNumber": "7" }, "location": { "court": { "standard": "FIBA", "lengthMetres": 28, "widthMetres": 15 }, "x": 0.72, "y": 0.41, "fromLeftBaselineMetres": 20.16, "fromTopSidelineMetres": 6.15 }, "customEventName": null } ] }, "error": null}Get the box score GET
Per-player and team totals already summed from the tagged events: points, shooting splits, rebounds, assists, steals, blocks, turnovers, fouls, minutes and efficiency. Matches what the Superstat app shows on the match report.
Get team insights GET
The written insights and ratings for your team in this match. Check status: ready means summary and ratings are included, not_generated means you should POST this URL, generating means a run is in progress and you should poll, failed means the last run failed, and unavailable means the match is not complete yet.