Live Timelines

get https://api.sportradar.com/basketball/{access_level}/v2/{language_code}/schedules/live/timelines.{format}

Global Basketball Live Timelines Provides a play-by-play event timeline for currently live games. Games appear a few minutes before tip-off and disappear a few minutes after the game reaches “ended” status.

⏱️
Update Frequency
1s Time To Live / Cache

Data Points

Sport Event Situation

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 game
`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 game
`home_normaltime_score`	`sport_event_status`	Integer	Score for the home team in normal time
`match_status`	`sport_event_status`	String	Status within a game (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 game winner ex. `sr:competitor:44`
`played`	`sport_event_status` - `clock`	String	Game time played in a quarter/period, in minutes ex. `00:36`
`remaining`	`sport_event_status` - `clock`	String	Time remaining in a quarter/period, in minutes ex. `9:21`

Game Timeline

Attribute	Parent Element	Type	Description
`id`	`sport_event_timeline`	String	Unique Id of a sport event ex. `sr:sport_event:46377483`
`start_time`	`sport_event_timeline`	Date-time	Start time of a sport event ex. `2024-04-23T18:15:00+00:00`
`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`.

Player Event Details

Attribute	Parent Element	Type	Description
`id`	`event` - `player`	String	Unique player Id associated with a timeline event ex. `sr:player:1876136`
`name`	`event` - `player`	String	Player name associated with a timeline event ex. `Edwards, Anthony`

Language

Credentials

Header

Click Try It! to start a request and see the response here!