Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Live Timelines Delta

Returns a 10 second delta of timeline information for currently live matches including live updates.

⏱️

Update Frequency

1s Time To Live / Cache



Data Points

Game State:
AttributeParent ElementTypeDescription
advantagesport_event_status - game_stateStringSignifies the competitor with the advantage in the game
home, away
away_scoresport_event_status - game_stateIntegerScore for the away competitor in a game
ex. 0, 15, 30, 40
home_scoresport_event_status - game_stateIntegerScore for the home competitor in a game
ex. 0, 15, 30, 40
last_point_resultsport_event_status - game_stateStringResult of the last point in a game
server_winner, receiver_winner, ace, double_fault
point_typesport_event_status - game_stateStringType of point scored
game, break, set, match
servingsport_event_status - game_stateStringSignifies the competitor currently serving
home, away
tie_breaksport_event_status - game_stateBooleanSignifies a match is in a tie break when true
Sport Event:
AttributeParent ElementTypeDescription
idsport_event_timeline_deltaStringUnique ID of a match
ex. sr:sport_event:51847153
start_timesport_event_timeline_deltaDateStart time of a match
ex. 2024-03-26T20:00:00+00:00
Sport Event Status:

Attribute

Parent Element

Type

Description

away_score

sport_event_status

Integer

Total score for the away competitor in a match

decided_by_fed

sport_event_status

Boolean

Signifies a match result was decided by the federation when true. For example, incomplete due to crowd disruption

home_score

sport_event_status

Integer

Total score for the home competitor in a match

match_status

sport_event_status

String

Status within a match (sport event). Provides more detail on the state of a match when live than status
ex. not_started, interrupted, 1st_set, walkover

See our FAQ for a complete list of statuses and their definitions.

scount_abandoned

sport_event_status

Boolean

Signifies a match 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:138546

winning_reason

sport_event_status

String

Winning reason description for a match
walkover, retirement, defaulted

See our FAQ for more info

Period Scores:
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway competitor set score
away_tiebreak_scoresport_event_status - period_scores - period_scoreIntegerAway competitor tiebreak set score
home_scoresport_event_status - period_scores - period_scoreIntegerHome competitor set score
home_tiebreak_scoresport_event_status - period_scores - period_scoreIntegerHome competitor tiebreak set score
numbersport_event_status - period_scores - period_scoreIntegerSet number
typesport_event_status - period_scores - period_scoreStringPeriod type
ex. set
Match Timeline:
AttributeParent ElementTypeDescription
away_scoretimeline - eventIntegerAway competitor point score
ex. 0, 15, 30, 40
competitortimeline - eventStringDesignation of a competitor for a timeline event
home, away
first_serve_faulttimeline - eventBooleanSignifies the first serve of a point was a fault when true
home_scoretimeline - eventIntegerHome competitor point score
ex. 0, 15, 30, 40
idtimeline - eventIntegerUnique ID for a timeline event
ex. 1804315823
periodtimeline - eventIntegerSet number of a timeline event. Populates for each period_score event.
period_nametimeline - eventStringPeriod name of a timeline event, appearing at the beginning of a period
ex. 2nd_set
reasontimeline - eventStringReason for a match_suspended event
toilet_break, bad_weather, trainer_called
resulttimeline - eventStringResult of an event
ace, double_fault, server_won, receiver_won, unknown
resulttimeline - eventStringResult of an event
ace, double_fault, server_won, receiver_won, unknown
servertimeline - eventStringServer for a timeline event
home, away
timetimeline - eventDate-timeTimestamp of a timeline event
ex. 2024-04-16T20:49:49+00:00
typetimeline - eventStringType of timeline event. See our Tennis OpenAPI for a complete list of event types under enum_event_type
ex. match_started, point, match_suspended
Language
Credentials
Header
Click Try It! to start a request and see the response here!