Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Info

Provides detailed information for a given season, including participating competitors and league structure.

⏱️

Update Frequency

300s Time To Live / Cache



Data Points

Category & Sport:
AttributeParent ElementTypeDescription
country_codeseason - categoryStringCountry code for a competition category
ex. ESP
idseason - categoryStringUnique category ID for a competition
ex. sr:category:183 (Spain)
nameseason - categoryStringName for a competition category
ex. Spain
idseason - sportStringUnique sport ID for a competitor
ex. sr:sport:29
nameseason - sportStringName for a competitor's sport
ex. Futsal
Competition:
AttributeParent ElementTypeDescription
genderseason - competitionStringGender for a competition
ex. men, women
idseason - competitionStringUnique ID for a competition
ex. sr:competition:770 (UEFA Futsal Champ. League)
nameseason - competitionStringName of a competition
ex. UEFA Futsal Champ. League
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:86029 (Primera Division 24/25)
max_roundsstage - groups - groupIntegerMaximum number of rounds for a stage or season
namestage - groups - groupStringName of a stage or season's group
ex. Primera Division 24/25
group_namestage - groups - groupStringAbbreviated name of a stage or season's group
ex. Relegation/Promotion
Season Info:

Attribute

Parent Element

Type

Description

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

Season:
AttributeParent ElementTypeDescription
competition_idseasonStringUnique ID for the competition a season belongs to
ex. sr:competition:593 (Primera Division)
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:121695 (Primera Division 24/25)
nameseasonStringName of a season
ex. Primera Division 24/25
start_dateseasonDateStart date of a season
ex. 2025-06-23
yearseasonStringYear of a season
ex. 24/25 or 2025
Stages:

Attribute

Parent Element

Type

Description

end_date

stage

Date

End date of a season or stage
ex. 2024-07-14

order

stage

Integer

Order of a stage within a season

phase

stage

String

Name of a season or stage
ex. playoffs, regular season

See the enum_phase entry in our Futsal OpenAPI spec for a complete list of valid phase enum values

start_date

stage

Date

Start date of a season or stage
ex. 2024-06-24

type

stage

String

Type of a season or stage
cup, league

year

stage

String

Year of a season or stage
ex. 23/24 or 2024

Competitor:
AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name
ex. FCB (FC Barcelona)
age_groupcompetitors - competitorStringAge group of a competitor, when applicable
ex. U23
countrycompetitors - competitorStringCountry of a competitor
ex. Spain
country_codecompetitors - competitorStringCountry code of a competitor
ex. ESP
gendercompetitors - competitorStringGender of a competitor
ex. male
idcompetitors - competitorStringUnique ID for a competitor
ex. sr:competitor:26215
namecompetitors - competitorStringName for a competitor
ex. FC Barcelona
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!