Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

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:
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away competitor in a match
decided_by_fedsport_event_statusBooleanSignifies a match result was decided by the federation when true. For example, incomplete due to crowd disruption
home_scoresport_event_statusIntegerTotal score for the home competitor in a match
match_statussport_event_statusStringStatus 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_abandonedsport_event_statusBooleanSignifies a match 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:138546
winning_reasonsport_event_statusStringWinning reason description for a match
ex. walkover
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
Authorization
Query
Click Try It! to start a request and see the response here!