Competition Seasons

get

https://api.sportradar.com/soccer/{access_level}/v4/{language_code}/competitions/{competition_id}/seasons.{format}

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: 300 seconds
Data Updates: Tournaments are added within 4 hours of official publication

Data Points

Competition

Attribute	Parent Element	Type	Description
`competition_id`	`season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:17` (Premier League)
`disabled`	`season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`season`	Date	End date of a season ex. `2024-05-19`
`id`	`season`	String	Unique ID for a season ex. `sr:season:105353` (Premier League 23/24)
`name`	`season`	String	Name of a season ex. `Premier League 23/24`
`start_date`	`season`	Date	Start date of a season ex. `2023-08-11`
`year`	`season`	String	Year of a season ex. `23/24`

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), id (Indonesian), it (Italian), ja (Japanese), nl (Dutch), pt (Portuguese), ru (Russian), sr (Serbian), srl (Serbian Latin), 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.

competition_id

string

required

Defaults to sr:competition:17

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

Example: sr:competition:17

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Response

Update Frequency

Data Points

200200