Season Info

get https://api.sportradar.com/americanfootball/{access_level}/v2/{language_code}/seasons/{season_id}/info.{format}

Global Football 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:

Attribute	Parent Element	Type	Description
`country_code`	`season` - `category`	String	Country code for a season's category ex. `USA`
`id`	`season` - `category`	String	Unique category ID for a season ex. `sr:category:43`
`name`	`season` - `category`	String	Name for a season's category ex. `USA`
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a season ex. `sr:sport:16`
`name`	`sport_event_context` - `sport`	String	Name for a season's sport ex. `American Football`

Competition:

Attribute	Parent Element	Type	Description
`gender`	`season` - `competition`	String	Gender for a competition `men`, `women`
`id`	`season` - `competition`	String	Unique ID for a competition ex. `sr:competition:790` (CFL)
`name`	`season` - `competition`	String	Name of a competition ex. `CFL`, `NFL`, `NCAA`
`parent_id`	`season` - `competition`	String	Unique parent ID for a competition. Typically present for group competitions ex. `sr:competition:30190` used to group NCAA postseason tournaments.

Groups:

Attribute	Parent Element	Type	Description
`id`	`stage` - `groups` - `group`	String	Unique ID for a stage or season's group ex. `sr:league:83007` (NFL 24/25, AFC)
`name`	`stage` - `groups` - `group`	String	Name of a stage or season's group ex. `NFL 24/25, AFC`
`group_name`	`stage` - `groups` - `group`	String	Abbreviated name of a stage or season's group ex. `AFC`
`max_rounds`	`stage` - `groups` - `group`	Integer	Maximum number of rounds for a stage or season
`parent_group_id`	`stage` - `groups` - `group`	String	Unique parent ID for a stage or season's group ex. `sr:league:83005` (NFL 24/25)

Seasons:

Attribute	Parent Element	Type	Description
`competition_id`	`season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:31` (NFL)
`disabled`	`season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`season`	Date	End date of a season ex. `2025-02-09`
`id`	`season`	String	Unique ID for a season ex. `sr:season:115087` (NFL 24/25)
`name`	`season`	String	Name of a season ex. `NFL 24/25`
`start_date`	`season`	Date	Start date of a season ex. `2024-09-05`
`year`	`season`	String	Year of a season ex. `24/25`

Stages:

Attribute	Parent Element	Type	Description
`end_date`	`stage`	Date	End date of a season or stage ex. `2024-05-19`
`order`	`stage`	Integer	Order of a stage within a season
`phase`	`stage`	String	Name of a season or stage ex. `regular season`, `conference`, `playoffs` See the enum_phase entry in our Global American Football OpenAPI spec for a complete list of valid `phase` enum values
`start_date`	`stage`	Date	Start date of a season or stage ex. `2023-08-11`
`type`	`stage`	String	Type of a season or stage `cup`, `league`
`year`	`stage`	String	Year of a season or stage ex. `23/24`

Competitor:

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `DEN` (Denver Broncos)
`age_group`	`competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `USA`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `USA` (United States))
`division`	`competitors` - `competitor`	Integer	Division number for a competitor
`gender`	`competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitors` - competitor`	String	Unique ID for a competitor ex. `sr:competitor:4418` (Denver Broncos)
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Denver Broncos`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a sport event `home`, `away`
`state`	`competitors` - `competitor`	String	State of a competitor ex. `CO` (Colorado)
`virtual`	`competitors` - `competitor`	Boolean	Signifies a competitor is a virtual team whan `true`. Used for placeholder teams in TBD vs TBD matchups.

Language

Credentials

Query

Click Try It! to start a request and see the response here!