Season Links

⏱️
Update Frequency
300s Time To Live / Cache

Data Points

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.

Groups, Rounds, Seasons, & 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`, `preliminary_round`, `qualification`, `playoffs` See our FAQ for a complete list of phases
`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`
`id`	`stages` - `groups` - `group`	String	Unique ID for a stage or season's group ex. `sr:cup:142213` (UEFA Euro 2024, Group D)
`group_name`	`stages` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `MLS 2023, Playoffs`
`order`	`stages` - `groups` - `group`	Integer	Order of the `cup_round` within the stage
`id`	`stages` - `groups` - `cup_rounds` - `cup_round`	String	Unique ID for a stage or season's cup round ex. `sr:cup_round:1741113`
`name`	`stages` - `groups` - `cup_rounds` - `cup_round`	String	Name of a stage or season's cup round ex. `round_3` or `round_of_16`
`order`	`stages` - `groups` - `cup_rounds` - `cup_round`	Integer	Order number for a match in a stage or season's cup round
`state`	`stages` - `groups` - `cup_rounds` - `cup_round`	String	State/status of a match 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`
`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:4819`

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:47395897`
`order`	`cup_rounds` - `sport_events` - `sport_event`	Integer	Order of the `sport_event` within the `cup_round`
`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`