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.Tournament Statuses
Tournaments progress frompending through finished, unless cancelled. See the Data Synchronization guide for best practices on keeping your data up to date.
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)
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.