API
Matches

Get a match

One match from your team’s perspective. If both teams in a match are in your club, the side that uploaded the footage is treated as team.

GET
/v1/matches/{matchId}

Authorization

apiKey
AuthorizationBearer <token>

Club API key, for example ss_live_…. Create one in the Superstat app under Settings → API keys.

In: header

Path Parameters

matchId*string

Match id.

Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/matches/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "data": {    "id": "d4e5f6a7-b8c9-4d0e-af12-3b4c5d6e7f80",    "playedAt": "2026-03-14T04:00:00.000Z",    "status": "complete",    "team": {      "id": "8c1d5e2f-3a4b-4c6d-9e0f-1a2b3c4d5e6f",      "name": "Northside U16 Boys",      "score": 68    },    "opponent": {      "id": "8c1d5e2f-3a4b-4c6d-9e0f-1a2b3c4d5e6f",      "name": "Northside U16 Boys",      "score": 68    },    "recordedBy": "team",    "opponentStatsTracked": true,    "thumbnailUrl": "https://cdn.superstatsport.com/matches/thumb.jpg",    "failureReason": null,    "periods": [      {        "id": "c9d0e1f2-a3b4-4c5d-9e67-8091021324a5",        "number": 1,        "type": "quarter",        "startedAt": "2026-03-14T04:00:12.000Z",        "endedAt": "2026-03-14T04:11:48.000Z"      }    ],    "createdAt": "2026-03-14T06:30:00.000Z"  },  "error": null}

List a team’s matches GET

Every match the team played, newest first, from that team’s perspective: team is always this team and opponent is the other side.

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.