Skip to main content
The Match object is the core catalog record for a fixture. It gives you the identifying information you need to look up live scores, subscribe to the WebSocket stream, or fetch a final result.

​
Used by

  • GET /matches
  • GET /matches/active
  • GET /matches/{id}

​
Fields

​
id
integer
required
Match id. Use this value as the match_id parameter for GET /matches/{id}/live, GET /matches/{id}/result, and WebSocket subscribe/unsubscribe messages.
​
home_team
string
required
Home team name.
​
away_team
string
required
Away team name.
​
start_time
datetime
required
Scheduled kick-off time in ISO 8601 UTC, e.g. 2026-06-18T02:00:00Z.
​
status
string
required
Current match status. One of the values below.

​
Status values

statusMeaning
NOT_STARTEDScheduled, not yet kicked off
STARTEDIn play (including half-time)
CLOSE_OF_PLAYA multi-day cricket Test between days — at stumps, still ongoing. Resumes the next day and stays visible until FINISHED.
FINISHEDCompleted
CLOSE_OF_PLAY is treated as live/ongoing alongside STARTED: matches in this state appear in /leagues/active, /matches/active, and the per-sport /matches/live feed, and CLOSE_OF_PLAY is a valid value for the status= filter on /matches.
Suspended or postponed matches are never returned by the API. They are filtered out of every catalog response.

​
Example

{
  "id": 41301,
  "home_team": "Salmon Bay FC (W)",
  "away_team": "West Seattle Rhodies FC (W)",
  "start_time": "2026-06-18T02:00:00Z",
  "status": "NOT_STARTED"
}