Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

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

Period Scores:
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
ex. 1st_half, 2nd_half, pause, 1st_extra, 2nd_extra, extra_time_halftime, awaiting_extra, interrupted, overtime, regular_period
Sport Event Status:

Attribute

Parent Element

Type

Description

away_score

sport_event_status

Integer

Total score for the away team in the match

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_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:4231

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. 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. 1856337905

match_clock

timeline - event

String

Clock value for a timeline event, in minutes and seconds
ex. 39:41

match_time

timeline - event

Integer

Clock value of a timeline event, in minutes
ex. 40

method

timeline - event

String

Type of score for a timeline event
try, penalty, penalty_try, conversion, drop_goal

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. 1st_half

time

timeline - event

Date-time

Timestamp of a timeline event
ex. 2024-09-28T15:02:11+00:00

type

timeline - event

String

Type of timeline event
ex. match_started, score_change, ball_kicked, turnover, substitution

See our FAQ for a complete list of timeline event values

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:
AttributeParent ElementTypeDescription
idevent - playerStringUnique player Id associated with a timeline event
ex. sr:player:474906
nameevent - playerStringPlayer name associated with a timeline event
ex. Gallo, Thomas
typeevent - playerStringType of event associated with a player
ex. scorer, substituted_in, substituted_out
Language
Credentials
Header
Click Try It! to start a request and see the response here!