⏱️
Update Frequency
1s Time To Live / Cache

Data Points

Category & Sport

Attribute	Parent Element	Type	Description
`country_code`	`sport_event_context` - `category`	String	Country code for a sport event's category
`id`	`sport_event_context` - `category`	String	Unique category ID for a sport event ex. `sr:category:259` (International)
`name`	`sport_event_context` - `category`	String	Name for a sport event's category ex. `International`
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a sport event ex. `sr:sport:31`
`name`	`sport_event_context` - `sport`	String	Name for a sport event's sport ex. `Badminton`

Competition

Attribute	Parent Element	Type	Description
`gender`	`sport_event_context` - `competition`	String	Gender for a competition ex. `men`, `women`, `mixed`
`id`	`sport_event_context` - `competition`	String	Unique ID for a competition ex. `sr:competition:41728` (Ruichang China Masters, MS)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `Ruichang China Masters, MS`, `Toyota Thailand Open, Doubles`
`parent_id`	`sport_event_context` - `competition`	String	Unique parent ID for a competition. ex. `sr:competition:41726` is used to group all Ruichang China Masters competitions.
`type`	`sport_event_context` - `competition`	String	Type of a competition ex. `singles`, `doubles`, `mixed_doubles`

Groups

Attribute	Parent Element	Type	Description
`id`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:cup:161825` (French Open 2024, MD)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `French Open 2024, MD`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group

Rounds

Attribute	Parent Element	Type	Description
`competition_sport_event_number`	`sport_event_context` - `round`	Integer	Sport event number within a competition. Used for competitions that have fixed match numbers.
`cup_round_id`	`sport_event_context` - `round`	String	Unique ID for a sport event's cup round ex. `sr:cup_round:1751367`
`cup_round_number_of_sport_events`	`sport_event_context` - `round`	Integer	Number of events in a sport event's round
`cup_round_sport_event_number`	`sport_event_context` - `round`	Integer	Number within the `cup_round` of a match ID. For example, 1st leg of 2
`name`	`sport_event_context` - `round`	String	Name of a match's round ex. `quarterfinal` or `final`
`number`	`sport_event_context` - `round`	Integer	Number of a match's round
`other_sport_event_id`	`sport_event_context` - `round`	String	A linked sport event ID, typically in a two-legged tie ex. `sr:sport_event:47395897`

Season

Attribute	Parent Element	Type	Description
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:559` (Olympic Tournament, Doubles)
`disabled`	`sport_event_context` - `season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`sport_event_context` - `season`	Date	End date of a season ex. `2025-07-13`
`id`	`season`	String	Unique ID for a season ex. `sr:season:119999` (Olympic Tournament, Doubles 2024)
`name`	`sport_event_context` - `season`	String	Name of a season ex. `Olympic Tournament, Doubles 2024`
`start_date`	`sport_event_context` - `season`	Date	Start date of a season ex. `2025-06-23`
`year`	`sport_event_context` - `season`	String	Year of a season ex. `24/25` or `2024`

Stages

Attribute	Parent Element	Type	Description
`end_date`	`sport_event_context` - `stage`	Date	End date of a sport event's stage ex. `2024-07-14`
`order`	`sport_event_context` - `stage`	Integer	Order of a stage within a season
`phase`	`sport_event_context` - `stage`	String	Name of a sport event's 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`	`sport_event_context` - `stage`	Date	Start date of a sport event's stage ex. `2024-06-24`
`type`	`sport_event_context` - `stage`	String	Type of a match's stage `cup`, `league`
`year`	`sport_event_context` - `stage`	String	Year of a match's stage ex. `23/24` or `2024`

Competitor

Competitors can be a player or a doubles 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`

Coverage Properties

Attribute	Parent Element	Type	Description
`live`	`sport_event` - `coverage`	String	Signifies a sport event is covered live when `true`

Sport Event

Attribute	Parent Element	Type	Description
`id`	`sport_event`	String	Unique ID of a match ex. `sr:sport_event:50453019`
`replaced_by`	`sport_event`	String	An alternative sport event ID if the match is postponed and played at a later date ex. `sr:sport_event:51847153`
`resume_time`	`sport_event`	Date	An updated timestamp if there is a delay at the start or interruption during a match ex. `2024-03-26T20:00:00+00:00`
`start_time`	`sport_event`	Date	Start time of a match ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies the start time of a match is confirmed when `true`

Sport Event Status

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status`	Integer	Total score for the away competitor in a match
`home_score`	`sport_event_status`	Integer	Total score for the home competitor in a match
`match_status`	`sport_event_status`	String	Status within a match (sport event). Provides more detail on the state of a match when live than `status` ex. `not_started`, `interrupted`, `1st_set`, `walkover` See our Badminton OAS for a complete list of statuses.
`scount_abandoned`	`sport_event_status`	Boolean	Signifies a match was abandoned by a scout when `true`
`status`	`sport_event_status`	String	Status of a sport event ex. `not_started`, `live`, `ended`, `closed` See our FAQ for a complete list of statuses and their definitions.
`winner_id`	`sport_event_status`	String	Unique ID of the match winner ex. `sr:competitor:174268`
`winning_reason`	`sport_event_status`	String	Winning reason description for a match ex. `walkover`

Period Scores

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away competitor set score
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home competitor set score
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Set number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Period type ex. `set`

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `14820`
`changed`	`venue`	Boolean	Signifies a venue has been changed when `true`
`city_name`	`venue`	String	City name of a venue ex. `Jakarta`
`country_code`	`venue`	String	Country code of a venue ex. `IDN` (England)
`country_name`	`venue`	String	Country name of a venue ex. `Indonesia`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:76057`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `54.707924, 25.236942`
`name`	`venue`	String	Name of a venue ex. `Court 1`, `Center Court`, or `Court 2`
`reduced_capacity`	`venue`	Boolean	Optional attribute signifying a venue has a restricted capacity when `true`
`reduced_capacity_max`	`venue`	Integer	Value of a venue's restricted capacity
`timezone`	`venue`	String	Timezone of a venue ex. `Asia/Jakarta`

200200