⏱️
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 competition category
`id`	`season` - `category`	String	Unique category ID for a competition ex. `sr:category:259` (International)
`name`	`season` - `category`	String	Name for a competition category ex. `ATP`
`id`	`season` - `sport`	String	Unique sport ID for a competitor ex. `sr:sport:31`
`name`	`season` - `sport`	String	Name for a competitor's sport ex. `Badminton`

Competition

Attribute	Parent Element	Type	Description
`gender`	`season` - `competition`	String	Gender for a competition ex. `men`, `women`, `mixed`
`id`	`season` - `competition`	String	Unique ID for a competition ex. `sr:competition:41728` (Ruichang China Masters, MS)
`name`	`season` - `competition`	String	Name of a competition ex. `Ruichang China Masters, MS`, `Toyota Thailand Open, Doubles`
`parent_id`	`season` - `competition`	String	Unique parent ID for a competition. ex. `sr:competition:41726` is used to group all Ruichang China Masters competitions.
`type`	`season` - `competition`	String	Type of a competition ex. `singles`, `doubles`, `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:58398` or `sr:cup:122226` (Olympic Tournament 2020, Final Round)
`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. `Group A` or `Olympic Tournament 2020, Final Round`
`group_name`	`stage` - `groups` - `group`	String	Abbreviated name of a stage or season's group ex. `A`

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

Attribute	Parent Element	Type	Description
`competition_id`	`season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:557` (Olympic Tournament)
`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:84966` (Olympic Tournament, Singles 2021)
`name`	`season`	String	Name of a season ex. `Olympic Tournament, Singles 2024`
`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. `ms` (men singles), `md` (men doubles), `ws` (women singles), `wd` (women doubles), `xd` (mixed doubles) See the enum_phase entry in our Badminton 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

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name (singles or doubles) ex. `SHI` (Shi, Yu Qi), `LIW` (Liang W K / Wang C)
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `China`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `CHN`
`date_of_birth`	`competitor` - `competitor`	Date	Date of birth of a competitor ex. `1996-02-28`
`gender`	`competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:164376`
`name`	`competitors` - `competitor`	String	Name for a competitor (singles or doubles) ex. `Shi, Yu Qi`, `Liang W K / Wang C`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a match `home`, `away`
`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.

Attribute	Parent Element	Type	Description
`abbreviation`	`competitor` - `players` - `player`	String	Abbreviation for a player name ex. `LIA` (Liang, Wei Keng)
`country`	`competitor` - `players` - `player`	String	Country of a competitor ex. `China`
`country_code`	`competitor` - `players` - `player`	String	Country code of a competitor ex. `CHN`
`date_of_birth`	`competitor` - `players` - `player`	Date	Date of birth of a player ex. `1994-07-05`
`id`	`competitor` - `players` - `player`	String	Unique ID for a competitor ex. `sr:competitor:569895`
`name`	`competitor` - `players` - `player`	String	Name for a competitor ex. `Liang, Wei Keng`

200200