Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Links

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

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 Badminton 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:163443 (European Championships 2024, MD)
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:2187565
namestages - groups - cup_rounds - cup_roundStringName of a stage or season's cup round

ex. round_of_16, 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
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:228480
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
Path Params
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json