Matches
List a team’s matches
Every match the team played, newest first, from that team’s perspective: team is always this team and opponent is the other side.
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
teamId*string
Team id.
Format
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/teams/497f6eca-6276-4993-bfeb-53cbbbba6f08/matches"{ "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}