Live Timelines Delta

get https://api.sportradar.com/tennis/{access_level}/v3/{language_code}/schedules/live/timelines_delta.{format}

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

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

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`

Language

Credentials

Header

Click Try It! to start a request and see the response here!