Season Info

Time	Status	User Agent
Retrieving recent requests…

⏱️
Update Frequency
TTL / Cache: 5 minutes
Data Updates: Structure and coverage are set at season start and rarely move
Recommended polling cadences for every feed are on the Update Frequencies chart of the Global Baseball Integration Guide.

📘
Loading Competitions and Seasons
Learn how to use the Season Info feed to read a season's structure and coverage before pulling its games in our Pulling Schedules and Results integration scenario.

Data Points

Category & Sport

Attribute	Parent Element	Type	Description
`country_code`	`season` - `category`	String	Country code for a competition category ex. `JPN` (Japan)
`id`	`season` - `category`	String	Unique category ID for a competition ex. `sr:category:211`
`name`	`season` - `category`	String	Name for a competition category ex. `Japan`
`id`	`season` - `sport`	String	Unique sport ID for a competitor ex. `sr:sport:3`
`name`	`season` - `sport`	String	Name for a competitor's sport ex. `Baseball`

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:1036` (NPB)
`name`	`season` - `competition`	String	Name of a competition ex. `NPB`, `Italian Baseball League`
`parent_id`	`season` - `competition`	String	Unique parent ID for a competition. Typically present for group competitions ex. `sr:competition:37221` used to group NCAA tournaments.

Coverage Properties

Attribute	Parent Element	Type	Description
`brackets`	`coverage` - `competition_properties`	Boolean	Signifies brackets in the Season Links endpoint are available for this season when `true`
`schedules`	`coverage` - `competition_properties`	Boolean	Signifies a schedule of fixtures is available for this season when `true`
`standings`	`coverage` - `competition_properties`	String	Defines whether a season's standings are available live or post-match `live`, `post`
`team_squads`	`coverage` - `competition_properties`	Boolean	Signifies team squads are available for competitors within this season when `true`
`type`	`coverage`	String	Type of coverage for a competition `sport_event`, `competition`
`basic_play_by_play`	`coverage` - `sport_event_properties`	Boolean	Signifies basic play-by-play of a competition's sport events are available when `true`
`scores`	`coverage` - `sport_event_properties`	Strings	Indicates when a competition's sport event scores are made available `live`, `post` (Postgame)

Groups

Attribute	Parent Element	Type	Description
`id`	`stage` - `groups` - `group`	String	Unique ID for a stage or season's group ex. `sr:league:80925` (National League West)
`name`	`stage` - `groups` - `group`	String	Name of a stage or season's group ex. `MLB 2024, National League West`
`group_name`	`stage` - `groups` - `group`	String	Abbreviated name of a stage or season's group ex. `National League West`
`max_rounds`	`stage` - `groups` - `group`	Integer	Maximum number of rounds for a stage or season

Seasons

Attribute	Parent Element	Type	Description
`competition_id`	`season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:1036` (NPB 2024)
`disabled`	`season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`season`	Date	End date of a season ex. `2024-11-03`
`id`	`season`	String	Unique ID for a season ex. `sr:season:99979` (World Baseball Classic 2023)
`name`	`season`	String	Name of a season ex. `NPB 2024`
`start_date`	`season`	Date	Start date of a season ex. `2024-03-29`
`year`	`season`	String	Year of a season ex. `23/24` or `2024`

Stages

Attribute	Parent Element	Type	Description
`end_date`	`stage`	Date	End date of a season or stage ex. `2024-10-01`
`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 Baseball OpenAPI spec for a complete list of valid `phase` enum values
`start_date`	`stage`	Date	Start date of a season or stage ex. `2024-03-20`
`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

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `LAD` (Los Angeles Dodgers)
`age_group`	`competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `Japan`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `JPN` (Japan)
`gender`	`competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:3638` (Los Angeles Dodgers)
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Los Angeles Dodgers`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a sport event `home`, `away`
`virtual`	`competitors` - `competitor`	Boolean	Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups.

Update Frequency

Loading Competitions and Seasons

Data Points

200200