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_dateseason_stages_groups_cup_rounds - stageDateEnd date of a season's stage
ex. 2024-05-19
orderseason_stages_groups_cup_rounds - stageIntegerOrder of a stage within a season
phaseseason_stages_groups_cup_rounds - stageStringName of a season's stage
ex. regular season, knockout_stage, placement_matches

See the enum_phase entry in our Handball OpenAPI spec for a complete list of valid phase enum values
start_dateseason_stages_groups_cup_rounds - stageDateStart date of a season's stage
ex. 2023-08-11
typeseason_stages_groups_cup_rounds - stageStringType of a season's stage
cup, league
yearseason_stages_groups_cup_rounds - stageStringYear of a season's stage
ex. 23/24
Groups:
AttributeParent ElementTypeDescription
idstages - groups - groupStringUnique ID for a stage or season's group
ex. sr:cup:119886 (European Championship 2022, Placement Matches)
group_namestages - groups - groupStringAbbreviated name of a sport event's group
ex. European Championship 2022, Placement Matches
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:1534659
namestages - groups - cup_rounds - cup_roundStringName of a stage or season's cup round
ex. quarterfinal or 3rd_place_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:5591
Sport Event:
AttributeParent ElementTypeDescription
idcup_rounds - sport_events - sport_eventStringUnique ID of a sport event
ex. sr:sport_event:31386669
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:41192363
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 sport event
ex. 2024-03-26T20:00:00+00:00
start_time_confirmedcup_rounds - sport_events - sport_eventBooleanSignifies the start time of a sport event is confirmed when true
Language
Credentials
Query
Click Try It! to start a request and see the response here!