Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Provides information about linked cup rounds for a given season.

Use this feed to compile full advancement brackets for relevant seasons/tournaments. Links between all matches and rounds are available when competitors (TBD vs. TBD) are not yet known.

⏱️

Update Frequency

300s Time To Live / Cache



Data Points

Stages:
AttributeParent ElementTypeDescription
end_datestageDateEnd date of a season or stage
ex. 2024-07-14
orderstageIntegerOrder of a stage within a season
phasestageStringName of a season or stage
ex. ms (men singles), md (men doubles), ws (women singles), wd (women doubles), xd (mixed doubles)

See the enum_phase entry in our Table Tennis OpenAPI spec for a complete list of valid phase enum values
start_datestageDateStart date of a season or stage
ex. 2024-06-24
typestageStringType of a season or stage
cup, league
yearstageStringYear of a season or stage
ex. 23/24 or 2024
Groups:
AttributeParent ElementTypeDescription
idstage - groups - groupStringUnique ID for a stage or season's group
ex. sr:cup:168495 (Olympic Tournament 2024, Knockout stage)
group_namestage - groups - groupStringAbbreviated name of a stage or season's group
ex. A
orderstages - groups - groupIntegerOrder of the cup_round within the stage
Cup Rounds:

Cup round info may reside within cup_round or linked_cup_rounds. Linked cup round info signifies parent or child rounds associated with the parent cup_round.

AttributeParent ElementTypeDescription
idstages - groups - cup_rounds - cup_roundStringUnique ID for a stage or season's cup round
ex. sr:cup_round:2177591
namestages - groups - cup_rounds - cup_roundStringName of a stage or season's cup round
ex. round_of_64, quarterfinal, final
orderstages - groups - cup_rounds - cup_roundIntegerOrder number for a game in a stage or season's cup round
statestages - groups - cup_rounds - cup_roundStringState/status of a game in a stage or season's cup round
ex. ended, decided, unstarted, cancelled, winner

See our FAQ for a complete list of state values and their definitions
typestages - groups - cup_rounds - cup_roundStringType of a stage or season's cup round
ex. parent or child
winner_idstages - groups - cup_rounds - cup_roundStringUnique ID for the winner of a stage or season's cup round
ex. sr:competitor:276375
Sport Event:
AttributeParent ElementTypeDescription
idcup_rounds - sport_events - sport_eventStringUnique ID of a match
ex. sr:sport_event:50453019
ordercup_rounds - sport_events - sport_eventIntegerOrder of the sport_event within the cup_round
replaced_bycup_rounds - sport_events - sport_eventStringAn alternative sport event ID if the match is postponed and played at a later date
ex. sr:sport_event:51847153
resume_timecup_rounds - sport_events - sport_eventDateAn updated timestamp if there is a delay at the start or interruption during a match
ex. 2024-03-26T20:00:00+00:00
start_timecup_rounds - sport_events - sport_eventDateStart time of a match
ex. 2024-03-26T20:00:00+00:00
start_time_confirmedcup_rounds - sport_events - sport_eventBooleanSignifies the start time of a match is confirmed when true
Language
Credentials
Query
Click Try It! to start a request and see the response here!