get https://api.sportradar.com///v3//schedules/live/timelines.
Provides a play-by-play event timeline for currently live games.
Update Frequency
1s Time To Live / Cache
Data Points
Period Scores:
Attribute | Parent Element | Type | Description |
---|---|---|---|
away_score | sport_event_status - period_scores - period_score | Integer | Away team period score |
home_score | sport_event_status - period_scores - period_score | Integer | Home team period score |
number | sport_event_status - period_scores - period_score | Integer | Period number |
type | sport_event_status - period_scores - period_score | String | Period type ex. 1st_half , 2nd_half , pause , 1st_extra , 2nd_extra , extra_time_halftime , awaiting_extra , interrupted , overtime , regular_period |
Sport Event Status:
Attribute | Parent Element | Type | Description |
---|---|---|---|
away_score | sport_event_status | Integer | Total score for the away team in the match |
away_normaltime_score | sport_event_status | Integer | Score for the away team in normal time |
home_score | sport_event_status | Integer | Total score for the home team in the match |
home_normaltime_score | sport_event_status | Integer | Score for the home team in normal time |
match_status | sport_event_status | String | Status within a match (sport event). Provides more detail on the state of a sport event when live than status ex. not_started , 1st_quarter , ended , cancelled See our FAQ for a complete list of statuses and their definitions. |
match_tie | sport_event_status | Boolean | Signifies a matched ended in a tie when true |
scount_abandoned | sport_event_status | Boolean | Signifies a sport event 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:4231 |
Game Timeline:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | sport_event_timeline | String | Unique Id of a sport event ex. sr:sport_event:46377483 |
start_time | sport_event_timeline | Date-time | Start time of a sport event ex. 2024-04-23T18:15:00+00:00 |
away_score | timeline - event | Integer | Score for the away team after a timeline event |
break_name | timeline - event | String | Brief description of a break event ex. pause |
competitor | timeline - event | String | Designation of a competitor for a timeline eventhome , away |
home_score | timeline - event | Integer | Score for the home team after a timeline event |
id | timeline - event | Integer | Unique ID for a timeline event ex. 1856337905 |
match_clock | timeline - event | String | Clock value for a timeline event, in minutes and seconds ex. 39:41 |
match_time | timeline - event | Integer | Clock value of a timeline event, in minutes ex. 40 |
method | timeline - event | String | Type of score for a timeline eventtry , penalty , penalty_try , conversion , drop_goal |
period | timeline - event | Integer | Period number of a timeline event |
period_name | timeline - event | String | Period name of a timeline event, appearing at the beginning of a period ex. 1st_half |
time | timeline - event | Date-time | Timestamp of a timeline event ex. 2024-09-28T15:02:11+00:00 |
type | timeline - event | String | Type of timeline event ex. match_started , score_change , ball_kicked , turnover , substitution See our FAQ for a complete list of timeline event values |
x | timeline - event | Integer | Horizontal X coordinate of a timeline event. x is a number between 0 and 100 . |
y | timeline - event | Integer | Vertical Y coordinate of a timeline event. y is a number between 0 and 100 . |
Player Event Details:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | event - player | String | Unique player Id associated with a timeline event ex. sr:player:474906 |
name | event - player | String | Player name associated with a timeline event ex. Gallo, Thomas |
type | event - player | String | Type of event associated with a player ex. scorer , substituted_in , substituted_out |