Season Info

⏱️
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
`id`	`season` - `category`	String	Unique category ID for a season. See our FAQ for a list of available categories/tours. ex. `sr:category:3` (ATP)
`name`	`season` - `category`	String	Name for a season's category. See our FAQ for a list of available categories/tours. ex. `ATP`, `WTA`, `Billie Jean King Cup`
`id`	`season` - `sport`	String	Unique sport ID for a season ex. `sr:sport:5`
`name`	`season` - `sport`	String	Name for a season's sport ex. `Tennis`

Competition:

Attribute	Parent Element	Type	Description
`gender`	`season` - `competition`	String	Gender for a competition `men`, `women`, `mixed`
`id`	`season` - `competition`	String	Unique ID for a competition ex. `sr:competition:2555` (Wimbledon Men Singles)
`level`	`season` - `competition`	String	Level of a competition `grand_slam`, `atp_1000`, `atp_500`, `atp_250`, `wta_premier`, `wta_international`, `atp_world_tour_finals`, `wta_championships`, `atp_next_generation`, `wta_elite_trophy`, `wta_master`, `wta_500`, `wta_250`, `wta_1000`, `wta_125`
`name`	`season` - `competition`	String	Name of a competition ex. `Wimbledon Men Singles`, `WTA Monterrey, Mexico Women Doubles`
`parent_id`	`season` - `competition`	String	Unique parent ID for a competition. ex. `sr:competition:2553` is used to group all Wimbledon competitions.
`type`	`season` - `competition`	String	Type of a competition ex. `singles`, `doubles`, `mixed`, `mixed_doubles`

Groups:

Attribute	Parent Element	Type	Description
`id`	`stage` - `groups` - `group`	String	Unique ID for a stage or season's group ex. `sr:league:150657` (2024 Wimbledon, London, Great Britain)
`max_rounds`	`stage` - `groups` - `group`	Integer	Maximum number of rounds for a stage or season
`name`	`stage` - `groups` - `group`	String	Name of a stage or season's group ex. `2024 Wimbledon, London, Great Britain`
`group_name`	`stage` - `groups` - `group`	String	Abbreviated name of a stage or season's group

Season Info:

Attribute	Parent Element	Type	Description
`competition_status`	`season` - `info`	String	Status of a competition Data point not currently in use
`complex`	`season` - `info`	String	Name of a complex for a season ex. `AO Arena`
`complex_id`	`season` - `info`	String	Unique ID of a complex for a season ex. `sr:complex:73227`
`number_of_competitors`	`season` - `info`	Integer	Number of competitors for a season
`number_of_qualified_competitors`	`season` - `info`	Integer	Number of qualified competitors for a season
`prize_currency`	`season` - `info`	String	Currency type for the prize money winner ex. `£`
`prize_money`	`season` - `info`	Integer	Amount of prize money for the champion ex. `17942000`
`surface`	`season` - `info`	String	Surface type for a season ex. `grass`
`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:

Attribute	Parent Element	Type	Description
`competition_id`	`season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:2555` (Wimbledon Men Singles)
`disabled`	`season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`season`	Date	End date of a season ex. `2025-07-13`
`id`	`season`	String	Unique ID for a season ex. `sr:season:120983` (Wimbledon Men Singles 2025)
`name`	`season`	String	Name of a season ex. `Wimbledon Men Singles 2025`
`start_date`	`season`	Date	Start date of a season ex. `2025-06-23`
`year`	`season`	String	Year 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. `stage_1_playoff`, `qualification` See the enum_phase entry in our Tennis 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:

Competitors can be a player, a doubles team, or a national team

Competitors may appear under a stage.group node for the given season, and also under a winner_last_season node for info on the past winner

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `PAU` (Tommy Paul) or `G/M` ('Glasspool L / Middelkoop M' doubles team)
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `USA`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `USA`
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:138546`
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Paul, Tommy` or `Glasspool L / Middelkoop M` (doubles team)
`virtual`	`competitors` - `competitor`	Boolean	Signifies a competitor is virtual when `true`. Used for placeholder players/teams in TBD vs TBD matchups.

Player:

Competitors will appear under a players node when part of a doubles competition.

Competitors may appear under a stage.group node for the given season, and also under a winner_last_season node for info on the past winner

Attribute	Parent Element	Type	Description
`abbreviation`	`competitor` - `players` - `player`	String	Abbreviation for a competitor name ex. `PAU` (Tommy Paul)
`country`	`competitor` - `players` - `player`	String	Country of a competitor ex. `USA`
`country_code`	`competitor` - `players` - `player`	String	Country code of a competitor ex. `USA`
`id`	`competitor` - `players` - `player`	String	Unique ID for a competitor ex. `sr:competitor:138546`
`name`	`competitor` - `players` - `player`	String	Name for a competitor ex. `Paul, Tommy`
`nationality`	`competitor` - `players` - `player`	String	Nationality of a player ex. `Japan`
`virtual`	`competitor` - `players` - `player`	Boolean	Signifies a competitor is virtual when `true`. Used for placeholder players/teams in TBD vs TBD matchups.