Season Info

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

Global Basketball Season Info Provides detailed information for a given season, including participating teams and league structure.

⏱️
Update Frequency
300s Time To Live / Cache

Data Points

Category & Sport:

Attribute	Parent Element	Type	Description
`country_code`	`sport_event_context` - `category`	String	Country code for a competition category ex. `FRA` (France)
`id`	`sport_event_context` - `category`	String	Unique category ID for a competition ex. `sr:category:110`
`name`	`sport_event_context` - `category`	String	Name for a competition category ex. `France`
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a competitor ex. `sr:sport:2`
`name`	`sport_event_context` - `sport`	String	Name for a competitor's sport ex. `Basketball`

Competition:

Attribute	Parent Element	Type	Description
`gender`	`sport_event_context` - `competition`	String	Gender for a competition `men`, `women`
`id`	`sport_event_context` - `competition`	String	Unique ID for a competition ex. `sr:competition:264` (Liga ACB)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `Pro A`, `NBA`
`parent_id`	`sport_event_context` - `competition`	String	Unique parent ID for a competition. Typically present for group competitions ex. `sr:competition:30190` used to group NCAA postseason tournaments.
`competition_status`	`season` - `info`	String	Status of a competition Data point not currently in use
`venue_reduced_capacity`	`season` - `info`	Boolean	Signifies venues within this competition have a reduced capacity when `true`
`venue_reduced_capacity_max`	`season` - `info`	Integer	Maximum capacity for a venue

Groups:

Attribute	Parent Element	Type	Description
`id`	`stage` - `groups` - `group`	String	Unique ID for a group ex. `sr:league:76103` (Euroleague 23/24)
`name`	`stage` - `groups` - `group`	String	Name of a group ex. `Euroleague 23/24`
`group_name`	`stage` - `groups` - `group`	String	Abbreviated name of a group ex. `D`

Seasons:

Attribute	Parent Element	Type	Description
`competition_id`	`season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:264` (Liga ACB)
`disabled`	`season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`season`	Date	End date of a season ex. `2024-06-17`
`id`	`season`	String	Unique ID for a season ex. `sr:season:108577` (Liga ACB 23/24)
`name`	`season`	String	Name of a season ex. `Liga ACB 23/24`
`start_date`	`season`	Date	Start date of a season ex. `2023-09-23`
`year`	`season`	String	Year of a season ex. `23/24`

Stages:

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

Competitor:

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `RMA` (Real Madrid)
`age_group`	`competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `Spain`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `ESP` (Spain)
`division`	`competitors` - `competitor`	Integer	Division number for a competitor
`gender`	`competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:3540` (Real Madrid)
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Real Madrid`
`state`	`competitors` - `competitor`	String	State of a competitor ex. `TX` (Texas)
`virtual`	`competitors` - `competitor`	Boolean	Signifies a competitor is a virtual team whan `true`. Used for placeholder teams in TBD vs TBD matchups.

Language

Authorization

Query

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