Season Links

get

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

Global Basketball 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

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
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 sport event's stage ex. `regular season`, `conference`, `playoffs` See the enum_phase entry in our Global Basketball 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:125136` (Euroleague 21/22, Playoffs)
`group_name`	`stages` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `Euroleague 21/22, Playoffs`
`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:1586373`
`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:3540`

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:33137845`
`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`

Path Params

access_level

string

enum

required

Defaults to trial

The access level of your API key

trial, production

Allowed:

language_code

string

enum

required

Defaults to en

2-letter code for supported languages

da (Danish), de (German), el (Greek), en (English), es (Spanish), fi (Finnish), fr (French), hi (Hindi), hu (Hungarian), id (Indonesian), it (Italian), ja (Japanese), ko (Korean), nl (Dutch), no (Norwegian), pt (Portuguese), ru (Russian), sr (Serbian), srl (Serbian Latin), sv (Swedish), th (Thai), tr (Turkish), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

season_id

string

required

Defaults to sr:season:130981

Unique Id of a season, found in the Seasons endpoint

Note: The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.

Example: sr:season:119811

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Update Frequency

Data Points

200200