Sport Event Timeline

get

https://api.sportradar.com/basketball/{access_level}/v2/{language_code}/sport_events/{sport_event_id}/timeline.{format}

Global Basketball Sport Event Timeline Provides real-time game-level statistics and a play-by-play event timeline for a given game. This includes scores by quarter and player and team stats. Please note that data returned is determined by coverage level.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
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_id`	`venue`	String	Unique ID of a city ex. `sr:city:59`
`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`

Path Params

access_level

string

enum

required

Defaults to trial

The access level of your API key

trial, production

Allowed:

language_code

string

enum

required

Defaults to en

2-letter code for supported languages

da (Danish), de (German), el (Greek), en (English), es (Spanish), fi (Finnish), fr (French), hi (Hindi), hu (Hungarian), id (Indonesian), it (Italian), ja (Japanese), ko (Korean), nl (Dutch), no (Norwegian), pt (Portuguese), ru (Russian), sr (Serbian), srl (Serbian Latin), sv (Swedish), th (Thai), tr (Turkish), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

sport_event_id

string

required

Defaults to sr:sport_event:62095826

Unique Id of a sport event

Example: sr:sport_event:51549831

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Response

Update Frequency

Data Points

200200