Competition Seasons

get

https://api.sportradar.com/{sport}/{access_level}/v2/{language_code}/competitions/{competition_id}/seasons.{format}

Global Baseball Competition Seasons provides historical season information for a given competition. Valid competition IDs can be found in the Competitions feed.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
TTL / Cache: 5 minutes
Data Updates: Change at season boundaries and when competitions are added
Recommended polling cadences for every feed are on the Update Frequencies chart of the Global Baseball Integration Guide.

📘
Loading Competitions and Seasons
Learn how to use the Competition Seasons feed to list a competition's seasons and pick the current one in our Pulling Schedules and Results integration scenario.

Data Points

Season

Attribute	Parent Element	Type	Description
`competition_id`	`season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:1036` (NPB 2024)
`disabled`	`season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`season`	Date	End date of a season ex. `2024-11-03`
`id`	`season`	String	Unique ID for a season ex. `sr:season:99979` (World Baseball Classic 2023)
`name`	`season`	String	Name of a season ex. `NPB 2024`
`start_date`	`season`	Date	Start date of a season ex. `2024-03-29`
`year`	`season`	String	Year of a season ex. `23/24` or `2024`

Path Params

sport

string

enum

required

Defaults to baseball

Sport type

baseball, softball

Allowed:

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

en (English), es (Spanish), ja (Japanese), ko (Korean), 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.

Allowed:

competition_id

string

required

Defaults to sr:competition:1036

Unique Id of a competition, found in the Competitions endpoint.

Example: sr:competition:1036

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Response

Update Frequency

Loading Competitions and Seasons

Data Points

200200