get
https://api.sportradar.com/tennis//v3//schedules/live/timelines.
Returns timeline information for currently live matches including live updates.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL/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 gamehome, 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 gameserver_winner, receiver_winner, ace, double_fault |
point_type | sport_event_status - game_state | String | Type of point scoredgame, break, set, match |
serving | sport_event_status - game_state | String | Signifies the competitor currently servinghome, 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 | String | Unique ID of a match ex. sr:sport_event:51847153 |
start_time | sport_event_timeline | 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 statusex. not_started, interrupted, 1st_set, walkoverSee 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, closedSee 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 matchwalkover, retirement, defaultedSee 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 eventhome, 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 eventtoilet_break, bad_weather, trainer_called |
result | timeline - event | String | Result of an eventace, double_fault, server_won, receiver_won, unknown |
result | timeline - event | String | Result of an eventace, double_fault, server_won, receiver_won, unknown |
server | timeline - event | String | Server for a timeline eventhome, 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 |