APIMatches
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.
GET
/v1/matches/{matchId}/eventscurl -X GET "https://api.superstatsport.com/v1/matches/3fa85f64-5717-4562-b3fc-2c963f66afa6/events" \
-H "Authorization: Bearer $SUPERSTAT_API_KEY"Authorization
AuthorizationstringheaderrequiredClub API key, for example
ss_live_…. Create one in the Superstat app under Settings → API keys.
Parameters
matchIdstring<uuid>pathrequiredMatch id.
Response
application/json
Success
dataMatchEventsrequirederrorobject | nullrequired
{
"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
}