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
5 possible statuses
Matches
8 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 or postponed. 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, bye and not_played?
What is the difference between retired, walkover, bye and not_played?
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, and has a winner. A bye means no match took place because there was no opponent to play. A not_played match had both pairs on the sheet and never took place, so there is no winner.Which statuses are permanent?
Which statuses are permanent?
Some match statuses are permanent once set and will never change:
finished, retired and walkover. Others are variable and will change as the match progresses: scheduled, live, and ended. bye and not_played are stable in practice, but they describe a match that was not played rather than a result, so they yield if a result is later recorded for that match.Point-by-Point Coverage
Matches with point-by-point data include acoverage field available in the /live endpoint, indicating how complete the tracking is.