Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Provides a play-by-play event timeline for currently live matches.

⏱️

Update Frequency

1s Time To Live / Cache



Data Points

Period Scores:
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway team period score
away_display_scoresport_event_status - period_scores - period_scoreStringAway team period display score ('Number of Goals'.'Number of Points'.'Total')
ex. 5.5.35
home_scoresport_event_status - period_scores - period_scoreIntegerHome team period score
home_display_scoresport_event_status - period_scores - period_scoreStringHome team period display score ('Number of Goals'.'Number of Points'.'Total')
ex. 5.5.35
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod type
regular_period, overtime, 1st_period, 2nd_period, 3rd_period, 4th_period, 1st_pause, 2nd_pause, 3rd_pause, interrupted
Sport Event Status:
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away team in the match
away_display_scoresport_event_statusIntegerDisplay score for the away team in the match ('Number of Goals'.'Number of Points'.'Total')
ex. 18.12.120
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time
home_scoresport_event_statusIntegerTotal score for the home team in the match
home_display_scoresport_event_statusIntegerDisplay score for the home team in the match ('Number of Goals'.'Number of Points'.'Total')
ex. 9.6.60
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time
match_statussport_event_statusStringStatus 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.
match_tiesport_event_statusBooleanSignifies a matched ended in a tie when true
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 match winner
ex. sr:competitor:4444
Game Timeline:
AttributeParent ElementTypeDescription
idsport_event_timelineStringUnique Id of a sport event
ex. sr:sport_event:46377483
start_timesport_event_timelineDate-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
away_display_scoretimeline - eventStringDisplay score for the away team after a timeline event ('Number of Goals'.'Number of Points'.'Total')
ex. 5.5.35
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
home_display_scoretimeline - eventStringDisplay score for the home team after a timeline event ('Number of Goals'.'Number of Points'.'Total')
ex. 5.5.35
idtimeline - eventIntegerUnique ID for a timeline event
ex. 1721786685
match_clocktimeline - eventStringClock value for a timeline event, in minutes and seconds
ex. 80:00
match_timetimeline - eventIntegerClock value of a timeline event, in minutes
ex. 66
methodtimeline - eventStringType of score for a timeline event
goal, behind
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
timetimeline - eventDate-timeTimestamp of a timeline event
ex. 2024-04-16T20:49:49+00:00
typetimeline - eventStringType of timeline event
match_started, match_ended, score_change, period_score, period_start, break_start
updatedtimeline - eventBooleanSignifies this event has been updated since its original entry when true
updated_timetimeline - eventDate-timeTimestamp of an updated time entry
ex. 2024-04-22T17:17:24+00:00
Player Event Details:
AttributeParent ElementTypeDescription
idevent - playerStringUnique player Id associated with a timeline event
ex. sr:player:1153060
nameevent - playerStringPlayer name associated with a timeline event
ex. Russell, Mercedes
typeevent - playerStringType of event associated with a player
ex. scorer, assist, substituted_in, substituted_out
Language
Credentials
Query
Click Try It! to start a request and see the response here!