⏱️
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 competition category ex. `FRA` (France)
`id`	`sport_event_context` - `category`	String	Unique category ID for a competition ex. `sr:category:110`
`name`	`sport_event_context` - `category`	String	Name for a competition category ex. `France`
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a competitor ex. `sr:sport:2`
`name`	`sport_event_context` - `sport`	String	Name for a competitor's sport ex. `Basketball`

Competition

Attribute	Parent Element	Type	Description
`gender`	`sport_event_context` - `competition`	String	Gender for a competition `men`, `women`
`id`	`sport_event_context` - `competition`	String	Unique ID for a competition ex. `sr:competition:264` (Liga ACB)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `Pro A`, `NBA`
`parent_id`	`sport_event_context` - `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`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:league:76103` (Euroleague 23/24)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `Euroleague 23/24`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `D`

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:1988995`
`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 sport event's round ex. `round_3` or `round_of_16`
`number`	`sport_event_context` - `round`	Integer	Number of a sport event'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`

Seasons

Attribute	Parent Element	Type	Description
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a sport event belongs to ex. `sr:competition:264` (Liga ACB)
`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 sport event's season ex. `2024-06-17`
`id`	`sport_event_context` - `season`	String	Unique ID for a sport event's season ex. `sr:season:108577` (Liga ACB 23/24)
`name`	`sport_event_context` - `season`	String	Name of a sport event's season ex. `Liga ACB 23/24`
`start_date`	`sport_event_context` - `season`	Date	Start date of a sport event's season ex. `2023-09-23`
`year`	`sport_event_context` - `season`	String	Year of a sport event's season ex. `23/24`

Stages

Attribute	Parent Element	Type	Description
`end_date`	`sport_event_context` - `stage`	Date	End date of a sport event's stage ex. `2024-05-19`
`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. `regular season`, `conference`, `playoffs` See the enum_phase entry in our Global Basketball 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. `2023-08-11`
`type`	`sport_event_context` - `stage`	String	Type of a sport event's stage `cup`, `league`
`year`	`sport_event_context` - `stage`	String	Year of a sport event's stage ex. `23/24`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `RMA` (Real Madrid)
`age_group`	`competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `Spain`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `ESP` (Spain)
`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:3540` (Real Madrid)
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Real Madrid`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a sport event `home`, `away`
`state`	`competitors` - `competitor`	String	State of a competitor ex. `TX` (Texas)

Player

Attribute	Parent Element	Type	Description
`id`	`statistics` - `competitor` - `player`	String	Unique ID of a player ex. `sr:player:608026`
`name`	`statistics` - `competitor` - `player`	String	Name of a player ex. `Tavares, Edy`

Sport Event

Attribute	Parent Element	Type	Description
`neutral`	`sport_event_conditions` - `ground`	Boolean	Signifies a neutral ground sport event when `true`
`id`	`sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:49796317`
`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:47395897`
`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 sport event ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies the start time of a sport event is confirmed when `true`

Sport Event - Coverage Properties

Attribute	Parent Element	Type	Description
`live`	`sport_event` - `coverage`	Boolean	Signifies a sport event is covered live when `true`
`type`	`sport_event` - `coverage` - `property`	String	Type of coverage for a sport event ex. `boxscore` or `lineups` See our FAQ for a complete list of coverage types and their descriptions
`value`	`sport_event` - `coverage` - `property`	Boolean	Signifies a coverage type is available when `true` For example, `type="lineups" value="true"` signifies lineups are available for this sport event

Period Scores

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away team period score
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home team period score
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Period number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Period type `regular_period`, `overtime`, `1st_quarter`, `2nd_quarter`, `3rd_quarter`, `4th_quarter`, `1st_half`, `2nd_half`, `penalties`, `1st_pause`, `2nd_pause`, `3rd_pause`, `awaiting_extra`, `awaiting_penalties`, `interrupted`, `1st_extra`, `2nd_extra`

Sport Event Status

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status`	Integer	Total score for the away team in the match
`away_normaltime_score`	`sport_event_status`	Integer	Score for the away team in normal time
`home_score`	`sport_event_status`	Integer	Total score for the home team in the match
`home_normaltime_score`	`sport_event_status`	Integer	Score for the home team in normal time
`match_status`	`sport_event_status`	String	Status within a match (sport event). Provides more detail on the state of a sport event when live than `status` ex. `not_started`, `1st_quarter`, `ended`, `cancelled` See our FAQ for a complete list of statuses and their definitions.
`scout_abandoned`	`sport_event_status`	Boolean	Signifies a sport event 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:44`

Game Stats (Player)

Attribute	Parent Element	Type	Description
`assists`	`player` - `statistics`	Integer	Number of assists for a player in a game
`blocks`	`player` - `statistics`	Integer	Number of shots blocked for a player in a game
`defensive_rebounds`	`player` - `statistics`	Integer	Number of defensive rebounds for a player in a game
`field_goals_attempted`	`player` - `statistics`	Integer	Number of field goal attempts for a player in a game
`field_goals_made`	`player` - `statistics`	Integer	Number of field goals for a player in a game
`free_throws_attempted`	`player` - `statistics`	Integer	Number of free throw attempts for a player in a game
`free_throws_made`	`player` - `statistics`	Integer	Number of free throws for a player in a game
`minutes`	`player` - `statistics`	Integer	Number of minutes played for a player in a game
`offensive_rebounds`	`player` - `statistics`	Integer	Number of offensive rebounds for a player in a game
`personal_fouls`	`player` - `statistics`	Integer	Number of personal fouls for a player in a game
`points`	`player` - `statistics`	Integer	Number of points for a player in a game
`steals`	`player` - `statistics`	Integer	Number of steals for a player in a game
`technical_fouls`	`player` - `statistics`	Integer	Number of technical fouls for a player in a game
`three_pointers_attempted`	`player` - `statistics`	Integer	Number of three point attempts for a player in a game
`three_pointers_made`	`player` - `statistics`	Integer	Number of three pointers for a player in a game
`total_rebounds`	`player` - `statistics`	Integer	Number of total rebounds (offense + defense) for a player in a game
`turnovers`	`player` - `statistics`	Integer	Number of turnovers for a player in a game

Game Stats (Team)

Attribute	Parent Element	Type	Description
`assists`	`competitor` - `statistics`	Integer	Number of assists for a team in a game
`ball_possession`	`competitor` - `statistics`	Integer	Percentage of team ball possession for a game
`biggest_lead`	`competitor` - `statistics`	Integer	Biggest lead in points for a team in a game
`defensive_rebounds`	`competitor` - `statistics`	Integer	Number of defensive rebounds for a team in a game
`fouls`	`competitor` - `statistics`	Integer	Number of fouls for a team in a game
`free_throw_attempts_successful`	`competitor` - `statistics`	Integer	Number of free throws for a team in a game
`free_throw_attempts_total`	`competitor` - `statistics`	Integer	Number of free throw attempts for a team in a game
`offensive_rebounds`	`competitor` - `statistics`	Integer	Number of offensive rebounds for a team in a game
`rebounds`	`competitor` - `statistics`	Integer	Number of total rebounds (offense + defense) for a team in a game
`shots_blocked`	`competitor` - `statistics`	Integer	Number of shots blocked for a team in a game
`steals`	`competitor` - `statistics`	Integer	Number of steals for a team in a game
`team_leads`	`competitor` - `statistics`	Integer	Number of times a team had a lead in a game
`team_rebounds`	`competitor` - `statistics`	Integer	Number of team rebounds in a game
`team_turnovers`	`competitor` - `statistics`	Integer	Number of team turnovers in a game
`three_point_attempts_successful`	`competitor` - `statistics`	Integer	Number of three pointers for a team in a game
`three_point_attempts_total`	`competitor` - `statistics`	Integer	Number of three point attempts for a team in a game
`time_spent_in_lead`	`competitor` - `statistics`	Integer	Number of minutes a team led in a game
`timeouts`	`competitor` - `statistics`	Integer	Number of timeouts used for a team in a game
`turnovers`	`competitor` - `statistics`	Integer	Number of turnovers for a team in a game
`two_point_attempts_successful`	`competitor` - `statistics`	Integer	Number of two pointers for a team in a game
`two_point_attempts_total`	`competitor` - `statistics`	Integer	Number of two point attempts for a team in a game

Game Timeline

Attribute	Parent Element	Type	Description
`away_score`	`timeline` - `event`	Integer	Score for the away team after a timeline event
`break_name`	`timeline` - `event`	String	Brief description of a break event ex. `1st_pause`
`competitor`	`timeline` - `event`	String	Designation of a competitor for a timeline event `home`, `away`
`home_score`	`timeline` - `event`	Integer	Score for the home team after a timeline event
`id`	`timeline` - `event`	Integer	Unique ID for a timeline event ex. `1721786685`
`match_clock`	`timeline` - `event`	String	Clock value for a timeline event, in minutes and seconds ex. `11:59`
`match_time`	`timeline` - `event`	Integer	Clock value of a timeline event, in minutes ex. `12`
`period`	`timeline` - `event`	Integer	Period number of a timeline event
`period_name`	`timeline` - `event`	String	Period name of a timeline event, appearing at the beginning of a period ex. `2nd_quarter`
`points`	`timeline` - `event`	Integer	Number of points for a timeline event. Value could be related to `attempt_missed` or `score_change` under `event.type`. ex. `1`, `2`, `3`
`time`	`timeline` - `event`	Date-time	Timestamp of a timeline event ex. `2024-04-16T20:49:49+00:00`
`type`	`timeline` - `event`	String	Type of timeline event. Reference enum_event_type in our Global Basketball OpenAPI Spec for a complete list of event types ex. `match_started`, `turnover`, `won_jump_ball`
`x`	`timeline` - `event`	Integer	Horizontal X coordinate of a timeline event. `x` is a number between `0` and `100`.
`y`	`timeline` - `event`	Integer	Vertical Y coordinate of a timeline event. `y` is a number between `0` and `100`.

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `15000`
`changed`	`venue`	Boolean	Signifies a venue has been changed when `true`
`city_name`	`venue`	String	City name of a venue ex. `Madrid`
`country_code`	`venue`	String	Country code of a venue ex. `ESP` (Spain)
`country_name`	`venue`	String	Country name of a venue ex. `Spain`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:7000`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `40.423889,-3.671667`
`name`	`venue`	String	Name of a venue ex. `WiZink Center`
`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. `Europe/Madrid`