Season Links

get https://api.sportradar.com/handball/{access_level}/v2/{language_code}/seasons/{season_id}/stages_groups_cup_rounds.{format}

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

Attribute	Parent Element	Type	Description
`end_date`	`season_stages_groups_cup_rounds` - `stage`	Date	End date of a season's stage ex. `2024-05-19`
`order`	`season_stages_groups_cup_rounds` - `stage`	Integer	Order of a stage within a season
`phase`	`season_stages_groups_cup_rounds` - `stage`	String	Name 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_date`	`season_stages_groups_cup_rounds` - `stage`	Date	Start date of a season's stage ex. `2023-08-11`
`type`	`season_stages_groups_cup_rounds` - `stage`	String	Type of a season's stage `cup`, `league`
`year`	`season_stages_groups_cup_rounds` - `stage`	String	Year of a season's stage ex. `23/24`

Groups

Attribute	Parent Element	Type	Description
`id`	`stages` - `groups` - `group`	String	Unique ID for a stage or season's group ex. `sr:cup:119886` (European Championship 2022, Placement Matches)
`group_name`	`stages` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `European Championship 2022, Placement Matches`
`order`	`stages` - `groups` - `group`	Integer	Order 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.

Attribute	Parent Element	Type	Description
`id`	`stages` - `groups` - `cup_rounds` - `cup_round`	String	Unique ID for a stage or season's cup round ex. `sr:cup_round:1534659`
`name`	`stages` - `groups` - `cup_rounds` - `cup_round`	String	Name of a stage or season's cup round ex. `quarterfinal` or `3rd_place_final`
`order`	`stages` - `groups` - `cup_rounds` - `cup_round`	Integer	Order number for a game in a stage or season's cup round
`state`	`stages` - `groups` - `cup_rounds` - `cup_round`	String	State/status of a game in a stage or season's cup round ex. `ended`, `decided`, `unstarted`, `cancelled`, `winner`
`type`	`stages` - `groups` - `cup_rounds` - `cup_round`	String	Type of a stage or season's cup round ex. `parent` or `child`
`winner_id`	`stages` - `groups` - `cup_rounds` - `cup_round`	String	Unique ID for the winner of a stage or season's cup round ex. `sr:competitor:5591`

Sport Event

Attribute	Parent Element	Type	Description
`id`	`cup_rounds` - `sport_events` - `sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:31386669`
`order`	`cup_rounds` - `sport_events` - `sport_event`	Integer	Order of the `sport_event` within the `cup_round`
`replaced_by`	`cup_rounds` - `sport_events` - `sport_event`	String	An alternative sport event ID if the match is postponed and played at a later date ex. `sr:sport_event:41192363`
`resume_time`	`cup_rounds` - `sport_events` - `sport_event`	Date	An updated timestamp if there is a delay at the start or interruption during a match ex. `2024-03-26T20:00:00+00:00`
`start_time`	`cup_rounds` - `sport_events` - `sport_event`	Date	Start time of a sport event ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`cup_rounds` - `sport_events` - `sport_event`	Boolean	Signifies the start time of a sport event is confirmed when `true`

Language

Credentials

Header

Click Try It! to start a request and see the response here!