status field that reflects their current state. This page describes all possible values for seasons, tournaments, matches, and point-by-point coverage.
Seasons
3 possible statuses
Tournaments
4 possible statuses
Matches
7 possible statuses
Season Statuses
Indicates whether a season is yet to start, currently active, or complete.| Status | Description |
|---|---|
upcoming | Season has not started yet |
active | Season is currently in progress |
finished | Season has concluded |
Tournament Statuses
Tournaments progress frompending through finished, unless cancelled. See the Data Synchronization guide for best practices on keeping your data up to date.
| Status | Description |
|---|---|
pending | Tournament is scheduled but has not started yet |
live | Tournament is currently in progress |
finished | Tournament has concluded |
cancelled | Tournament was cancelled |
Match Statuses
Matches progress through the following statuses. See the Data Synchronization guide for best practices on keeping your data up to date.scheduled → finished (without live coverage)
scheduled → live → ended → finished (with live coverage)
| Status | Description |
|---|---|
scheduled | Match has not started yet |
live | Match is in progress with real-time point-by-point data available |
ended | Match has ended but the score is not yet confirmed |
finished | Match completed with confirmed score |
| Other statuses | |
retired | Match ended early due to a player retirement |
walkover | Match awarded without play |
bye | Match was not played (no opponent) |
What is the difference between ended and finished?
What is the difference between ended and finished?
Both statuses mean the match is over, but
ended is a transitional state where the match has concluded on court but the score has not yet been confirmed. It will automatically transition to finished within a few minutes once the result is processed. Note that ended only appears on matches with live tracking — matches without live coverage transition directly from scheduled to finished.What is the difference between retired, walkover and bye?
What is the difference between retired, walkover and bye?
A
retired match started and has a partial score — one team couldn’t continue. A walkover was awarded before play began, typically due to an injury or withdrawal. A bye means no match took place because there was no opponent to play.Which statuses are permanent?
Which statuses are permanent?
Some match statuses are permanent once set and will never change:
finished, retired, walkover, and bye. Others are variable and will change as the match progresses: scheduled, live, and ended.Point-by-Point Coverage
Matches with point-by-point data include acoverage field available in the /live endpoint, indicating how complete the tracking is.
| Coverage | Description |
|---|---|
tracking | Match is live — coverage will be determined once it ends |
full | All games are tracked and match the confirmed score |
partial | Some games are missing due to gaps in the live feed |
null | No point-by-point data available for this match |