Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Seasons

Soccer Extended Seasons provides a list of historical season information for all competitions. Competitions will return a maximum of three seasons of data, including current or newly created seasons.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

300s Time To Live / Cache


Data Points

Season
AttributeParent ElementTypeDescription
competition_idseasonStringUnique ID for the competition a season belongs to
ex. sr:competition:17 (Premier League)
disabledseasonBooleanSignifies a season has been disabled when true
end_dateseasonDateEnd date of a season
ex. 2024-05-19
idseasonStringUnique ID for a season
ex. sr:season:105353 (Premier League 23/24)
nameseasonStringName of a season
ex. Premier League 23/24
start_dateseasonDateStart date of a season
ex. 2023-08-11
yearseasonStringYear of a season
ex. 23/24
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
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.

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json