Live Timelines Delta

get

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

Global Basketball Live Timelines Delta Provides a 10 second live delta of game information, including scoring and a play-by-play event timeline.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
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_delta`	String	Unique Id of a sport event ex. `sr:sport_event:46377483`
`start_time`	`sport_event_timeline_delta`	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`

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.

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json