Live Timelines Delta

Time	Status	User Agent
Retrieving recent requests…

⏱️
Update Frequency
TTL/Cache: 1 second
Data Updates (Tier 1): Updates are made during live play and up to one hour after the match

📘
Tracking Live Matches
Learn how to use the Live Timelines Delta for efficient incremental updates during live play in our Tracking Live Matches integration scenario.

Data Points

Game State

Attribute	Parent Element	Type	Description
`advantage`	`sport_event_status` - `game_state`	String	Signifies the competitor with the advantage in the game `home`, `away`
`away_score`	`sport_event_status` - `game_state`	Integer	Score for the away competitor in a game ex. `0`, `15`, `30`, `40`
`home_score`	`sport_event_status` - `game_state`	Integer	Score for the home competitor in a game ex. `0`, `15`, `30`, `40`
`last_point_result`	`sport_event_status` - `game_state`	String	Result of the last point in a game `server_winner`, `receiver_winner`, `ace`, `double_fault`
`point_type`	`sport_event_status` - `game_state`	String	Type of point scored `game`, `break`, `set`, `match`
`serving`	`sport_event_status` - `game_state`	String	Signifies the competitor currently serving `home`, `away`
`tie_break`	`sport_event_status` - `game_state`	Boolean	Signifies a match is in a tie break when `true`

Sport Event

Attribute	Parent Element	Type	Description
`id`	`sport_event_timeline_delta`	String	Unique ID of a match ex. `sr:sport_event:51847153`
`start_time`	`sport_event_timeline_delta`	Date	Start 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.
`count_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

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away competitor set score
`away_tiebreak_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away competitor tiebreak set score
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home competitor set score
`home_tiebreak_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home competitor tiebreak set score
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Set number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Period type ex. `set`

Match Timeline

Attribute	Parent Element	Type	Description
`away_score`	`timeline` - `event`	Integer	Away competitor point score ex. `0`, `15`, `30`, `40`
`competitor`	`timeline` - `event`	String	Designation of a competitor for a timeline event `home`, `away`
`first_serve_fault`	`timeline` - `event`	Boolean	Signifies the first serve of a point was a fault when `true`
`home_score`	`timeline` - `event`	Integer	Home competitor point score ex. `0`, `15`, `30`, `40`
`id`	`timeline` - `event`	Integer	Unique ID for a timeline event ex. `1804315823`
`period`	`timeline` - `event`	Integer	Set number of a timeline event. Populates for each `period_score` event.
`period_name`	`timeline` - `event`	String	Period name of a timeline event, appearing at the beginning of a period ex. `2nd_set`
`reason`	`timeline` - `event`	String	Reason for a `match_suspended` event `toilet_break`, `bad_weather`, `trainer_called`
`result`	`timeline` - `event`	String	Result of an event `ace`, `double_fault`, `server_won`, `receiver_won`, `unknown`
`result`	`timeline` - `event`	String	Result of an event `ace`, `double_fault`, `server_won`, `receiver_won`, `unknown`
`server`	`timeline` - `event`	String	Server for a timeline event `home`, `away`
`time`	`timeline` - `event`	Date-time	Timestamp of a timeline event ex. `2024-04-16T20:49:49+00:00`
`type`	`timeline` - `event`	String	Type of timeline event. See our Tennis OpenAPI for a complete list of event types under enum_event_type ex. `match_started`, `point`, `match_suspended`

Update Frequency

Tracking Live Matches

Data Points

200200