Returns a 10 second delta of timeline information for currently live matches including live updates.
Update Frequency1s Time To Live / Cache
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_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 |
---|---|---|---|
|
| Integer | Total score for the away competitor in a match |
|
| Boolean | Signifies a match result was decided by the federation when |
|
| Integer | Total score for the home competitor in a match |
|
| String | Status within a match (sport event). Provides more detail on the state of a match when live than |
|
| Boolean | Signifies a match was abandoned by a scout when |
|
| String | Status of a sport event |
|
| String | Unique ID of the match winner |
|
| String | Winning reason description for a match |
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 |