Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Live Timelines Delta

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

⏱️

Update Frequency

1s Time To Live / Cache



Data Points

Sport Event Situation:
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway team period score
home_scoresport_event_status - period_scores - period_scoreIntegerHome team period score
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod 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:
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away team in the game
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time
home_scoresport_event_statusIntegerTotal score for the home team in the game
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time
match_statussport_event_statusStringStatus 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.
scount_abandonedsport_event_statusBooleanSignifies a sport event was abandoned by a scout when true
statussport_event_statusStringStatus of a sport event
ex. not_started, live, ended, closed

See our FAQ for a complete list of statuses and their definitions.
winner_idsport_event_statusStringUnique ID of the game winner
ex. sr:competitor:44
playedsport_event_status - clockStringGame time played in a quarter/period, in minutes
ex. 00:36
remainingsport_event_status - clockStringTime remaining in a quarter/period, in minutes
ex. 9:21
Game Timeline:
AttributeParent ElementTypeDescription
idsport_event_timeline_deltaStringUnique Id of a sport event
ex. sr:sport_event:46377483
start_timesport_event_timeline_deltaDate-timeStart time of a sport event
ex. 2024-04-23T18:15:00+00:00
away_scoretimeline - eventIntegerScore for the away team after a timeline event
break_nametimeline - eventStringBrief description of a break event
ex. 1st_pause
competitortimeline - eventStringDesignation of a competitor for a timeline event
home, away
home_scoretimeline - eventIntegerScore for the home team after a timeline event
idtimeline - eventIntegerUnique ID for a timeline event
ex. 1721786685
match_clocktimeline - eventStringClock value for a timeline event, in minutes and seconds
ex. 11:59
match_timetimeline - eventIntegerClock value of a timeline event, in minutes
ex. 12
periodtimeline - eventIntegerPeriod number of a timeline event
period_nametimeline - eventStringPeriod name of a timeline event, appearing at the beginning of a period
ex. 2nd_quarter
pointstimeline - eventIntegerNumber of points for a timeline event. Value could be related to attempt_missed or score_change under event.type.
ex. 1, 2, 3
timetimeline - eventDate-timeTimestamp of a timeline event
ex. 2024-04-16T20:49:49+00:00
typetimeline - eventStringType 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
xtimeline - eventIntegerHorizontal X coordinate of a timeline event. x is a number between 0 and 100.
ytimeline - eventIntegerVertical Y coordinate of a timeline event. y is a number between 0 and 100.
Player Event Details:
AttributeParent ElementTypeDescription
idevent - playerStringUnique player Id associated with a timeline event
ex. sr:player:1876136
nameevent - playerStringPlayer name associated with a timeline event
ex. Edwards, Anthony
Language
Authorization
Query
Click Try It! to start a request and see the response here!