Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

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
AttributeParent ElementTypeDescription
country_codeseason - categoryStringCountry code for a competition category
idseason - categoryStringUnique category ID for a competition

ex. sr:category:166 (International)
nameseason - categoryStringName for a competition category

ex. International
idseason - sportStringUnique sport ID for a competitor

ex. sr:sport:24
nameseason - sportStringName for a competitor's sport

ex. Field hockey
Competition
AttributeParent ElementTypeDescription
genderseason - competitionStringGender for a competition

ex. men, women
idseason - competitionStringUnique ID for a competition

ex. sr:competition:549 (Olympic Tournament, Women)
nameseason - competitionStringName of a competition

ex. Olympic Tournament, Women
parent_idseason - competitionStringUnique parent ID for a competition
Groups
AttributeParent ElementTypeDescription
idstage - groups - groupStringUnique ID for a stage or season's group

ex. sr:league:82557 (Group A) or sr:cup:162807 (Olympic Tournament, Women 2024, Knockout stage)
max_roundsstage - groups - groupIntegerMaximum number of rounds for a stage or season
namestage - groups - groupStringName of a stage or season's group

ex. Group A or Olympic Tournament, Women 2024, Knockout stage
group_namestage - groups - groupStringAbbreviated name of a stage or season's group

ex. A or Relegation/Promotion
Season
AttributeParent ElementTypeDescription
competition_idseasonStringUnique ID for the competition a season belongs to

ex. sr:competition:549 (Olympic Tournament, Women)
disabledseasonBooleanSignifies a season has been disabled when true
end_dateseasonDateEnd date of a season

ex. 2025-07-13
idseasonStringUnique ID for a season

ex. sr:season:105527 (Olympic Tournament, Women 2024)
nameseasonStringName of a season

ex. Olympic Tournament, Women 2024
start_dateseasonDateStart date of a season

ex. 2025-06-23
yearseasonStringYear of a season

ex. 24/25 or 2025
Stages
AttributeParent ElementTypeDescription
end_datestageDateEnd date of a season or stage

ex. 2024-07-14
orderstageIntegerOrder of a stage within a season
phasestageStringName of a season or stage

ex. playoffs, regular season
start_datestageDateStart date of a season or stage

ex. 2024-06-24
typestageStringType of a season or stage

cup, league
yearstageStringYear of a season or stage

ex. 23/24 or 2024
Competitor
AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name

ex. CAN
age_groupcompetitors - competitorStringAge group of a competitor, when applicable

ex. U23
countrycompetitors - competitorStringCountry of a competitor

ex. Canada
country_codecompetitors - competitorStringCountry code of a competitor

ex. CAN
gendercompetitors - competitorStringGender of a competitor

ex. male
idcompetitors - competitorStringUnique ID for a competitor

ex. sr:competitor:24451
namecompetitors - competitorStringName for a competitor

ex. Canada
virtualcompetitors - competitorBooleanSignifies a competitor is virtual when true. Used for placeholder players/teams in TBD vs TBD matchups.
Language
Credentials
Header
Click Try It! to start a request and see the response here!