Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Live Timelines

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:

Attribute

Parent Element

Type

Description

away_score

sport_event_status

Integer

Total score for the away team in the match

away_display_score

sport_event_status

Integer

Display score for the away team in the match ('Number of Goals'.'Number of Points'.'Total')
ex. 18.12.120

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_display_score

sport_event_status

Integer

Display score for the home team in the match ('Number of Goals'.'Number of Points'.'Total')
ex. 9.6.60

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.

match_tie

sport_event_status

Boolean

Signifies a matched ended in a tie when true

scount_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: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
Header
Click Try It! to start a request and see the response here!