get https://api.sportradar.com/soccer-extended//v4//sport_events//timeline.
Soccer Extended Sport Event Timeline provides real-time match-level statistics and a play-by-play event timeline for a given match. This includes player and team stats, scoring info, channel availability, x/y event coordinates, and human-readable event descriptions. Please note that data returned is determined by coverage level.
Update Frequency
1s Time To Live / Cache
Data Points
Category & Sport:
Attribute | Parent Element | Type | Description |
---|---|---|---|
country_code | sport_event_context - category | String | Country code for a sport event's category ex. ENG (England) |
id | sport_event_context - category | String | Unique category ID for a sport event ex. sr:category:1 |
name | sport_event_context - category | String | Name for a sport event's category ex. England (Premier League) |
id | sport_event_context - sport | String | Unique sport ID for a sport event ex. sr:sport:1 |
name | sport_event_context - sport | String | Name for a sport event's sport ex. Soccer |
Competition:
Attribute | Parent Element | Type | Description |
---|---|---|---|
gender | sport_event_context - competition | String | Gender for a competition ex. men |
id | sport_event_context - competition | String | Unique ID for a competition ex. sr:competition:17 (Premier League) |
name | sport_event_context - competition | String | Name of a competition ex. Premier League |
parent_id | sport_event_context - competition | String | Unique parent ID for a competition. Typically present for group stage or playoff competitions ex. sr:competition:945 used to link competitions together, like the World Cup and the various qualifiers. |
Group:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | sport_event_context - groups - group | String | Unique ID for a sport event's group ex. sr:league:80253 (UEFA Euro 2024, Group D) |
name | sport_event_context - groups - group | String | Name of a sport event's group ex. UEFA Euro 2024, Group D |
group_name | sport_event_context - groups - group | String | Abbreviated name of a sport event's group ex. D |
Round:
Attribute | Parent Element | Type | Description |
---|---|---|---|
competition_sport_event_number | sport_event_context - round | Integer | Sport event number within a competition. Used for competitions that have fixed match numbers (World Cup) |
cup_round_id | sport_event_context - round | String | Unique ID for a sport event's cup round ex. sr:cup_round:1988995 |
cup_round_number_of_sport_events | sport_event_context - round | Integer | Number of events in a sport event's round |
cup_round_sport_event_number | sport_event_context - round | Integer | Number within the cup_round of a match ID. For example, 1st leg of 2 |
name | sport_event_context - round | String | Name of a sport event's round ex. round_3 or round_of_16 |
number | sport_event_context - round | Integer | Number of a sport event's round |
other_sport_event_id | sport_event_context - round | String | A linked sport event ID, typically in a two-legged tie ex. sr:sport_event:47395897 |
Season:
Attribute | Parent Element | Type | Description |
---|---|---|---|
competition_id | sport_event_context - season | String | Unique ID for the competition a sport event belongs to ex. sr:competition:17 (Premier League) |
disabled | sport_event_context - season | Boolean | Signifies a season has been disabled when true |
end_date | sport_event_context - season | Date | End date of a sport event's season ex. 2024-05-19 |
id | sport_event_context - season | String | Unique ID for a sport event's season ex. sr:season:105353 (Premier League 23/24) |
name | sport_event_context - season | String | Name of a sport event's season ex. Premier League 23/24 |
start_date | sport_event_context - season | Date | Start date of a sport event's season ex. 2023-08-11 |
year | sport_event_context - season | String | Year of a sport event's season ex. 23/24 |
Stage:
Attribute | Parent Element | Type | Description |
---|---|---|---|
end_date | sport_event_context - stage | Date | End date of a sport event's stage ex. 2024-05-19 |
order | sport_event_context - stage | Integer | Order of a stage within a season |
phase | sport_event_context - stage | String | Name of a sport event's stage ex. regular season , preliminary_round , qualification |
start_date | sport_event_context - stage | Date | Start date of a sport event's stage ex. 2023-08-11 |
type | sport_event_context - stage | String | Type of a sport event's stagecup , league |
year | sport_event_context - stage | String | Year of a sport event's stage ex. 23/24 |
Competitor:
Competitor information appears in the
competitors
node under bothsport_event
andstatistics
Attribute | Parent Element | Type | Description |
---|---|---|---|
abbreviation | competitors - competitor | String | Abbreviation for a competitor name ex. LIV (Liverpool FC) |
age_group | competitors - competitor | String | Age group of a competitor, when applicable ex. U23 |
country | competitors - competitor | String | Country of a competitor ex. England |
country_code | competitors - competitor | String | Country code of a competitor ex. ENG (England) |
gender | competitors - competitor | String | Gender for a competitormale , female |
id | competitors - competitor | String | Unique ID for a competitor ex. sr:competitor:44 (Liverpool FC) |
name | competitors - competitor | String | Name for a competitor ex. Liverpool FC |
qualifier | competitors - competitor | String | Designation of a competitor for a sport eventhome , away |
virtual | competitors - competitor | Boolean | Signifies a competitor is a virtual team whan true . Used for placeholder teams in TBD vs TBD matchups. |
Player:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | statistics - competitor - player | String | Unique ID of a player ex. sr:player:159665 |
name | statistics - competitor - player | String | Name of a player ex. Salah, Mohamed |
starter | statistics - competitor - player | Boolean | Signifies a player is in the starting lineup for a sport event when true |
Sport Event:
Attribute | Parent Element | Type | Description |
---|---|---|---|
count | sport_event_conditions - attendance | Integer | Attendance for a sport event ex. 25078 |
neutral | sport_event_conditions - ground | Boolean | Signifies a neutral ground sport event when true |
confirmed | sport_event_conditions - lineups | Boolean | Signifies lineups for a sport event have been confirmed when true |
id | sport_event | String | Unique ID of a sport event ex. sr:sport_event:47395897 |
replaced_by | sport_event | String | An alternative sport event ID if the match is postponed and played at a later date ex. sr:sport_event:47395897 |
resume_time | sport_event | Date | An updated timestamp if there is a delay at the start or interruption during a match ex. 2024-03-26T20:00:00+00:00 |
start_time | sport_event | Date | Start time of a sport event ex. 2024-03-26T20:00:00+00:00 |
start_time_confirmed | sport_event | Boolean | Signifies the start time of a sport event is confirmed when true |
overall_conditions | sport_event_conditions - weather | String | Weather conditions for a sport eventgood , medium , bad , indoor , extreme |
pitch_conditions | sport_event_conditions - weather | String | Pitch conditions for a sport eventgood , medium , bad |
Sport Event - Channel:
Attribute | Parent Element | Type | Description |
---|---|---|---|
country | sport_event - channels - channel | String | Country of a broadcast channel ex. United States |
country_code | sport_event - channels - channel | String | Country code of a broadcast channel ex. USA |
name | sport_event - channels - channel | String | Name of a broadcast channel ex. Fox Soccer Plus |
url | sport_event - channels - channel | String | URL of a broadcast channel |
Sport Event - Referee:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | sport_event_conditions - referees - referee | String | Unique ID for a referee ex. sr:referee:229470 |
name | sport_event_conditions - referees - referee | String | Name of a referee ex. Brooks, John |
nationality | sport_event_conditions - referees - referee | String | Nationality of a referee ex. England |
country_code | sport_event_conditions - referees - referee | String | Country code of a referee ex. ENG |
type | sport_event_conditions - referees - referee | String | Type of a referee ex. first_assistant_referee , second_assistant_referee , fourth_official , video_assistant_referee , first_additional_assistant , second_additional_assistant , main_referee |
Sport Event - Coverage Properties:
Attribute | Parent Element | Type | Description |
---|---|---|---|
type | sport_event - coverage | String | Type of coveragesport_event , group , competition |
ballspotting | sport_event - coverage - sport_event_properties | Boolean | Signifies ballspotting is available for a sport event when true |
basic_play_by_play | sport_event - coverage - sport_event_properties | Boolean | Signifies basic play-by-play is available for a sport event when true |
basic_player_stats | sport_event - coverage - sport_event_properties | Boolean | Signifies basic player stats is available for a sport event when true |
basic_team_stats | sport_event - coverage - sport_event_properties | Boolean | Signifies basic team stats is available for a sport event when true |
commentary | sport_event - coverage - sport_event_properties | Boolean | Signifies commentary is available for a sport event when true |
deeper_play_by_play | sport_event - coverage - sport_event_properties | Boolean | Signifies deeper play-by-play is available for a sport event when true |
deeper_player_stats | sport_event - coverage - sport_event_properties | Boolean | Signifies deeper player stats is available for a sport event when true |
deeper_team_stats | sport_event - coverage - sport_event_properties | Boolean | Signifies deeper team stats is available for a sport event when true |
extended_player_stats | sport_event - coverage - sport_event_properties | Boolean | Signifies extended player stats is available for a sport event when true |
extended_team_stats | sport_event - coverage - sport_event_properties | Boolean | Signifies extended team stats is available for a sport event when true |
fun_facts | sport_event - coverage - sport_event_properties | Boolean | Signifies fun facts are available for a sport event when true |
game_clock | sport_event - coverage - sport_event_properties | Boolean | Signifies the game glock is available for a sport event when true |
goal_scorers | sport_event - coverage - sport_event_properties | Boolean | Signifies goal scorers are available for a sport event when true |
lineups | sport_event - coverage - sport_event_properties | Boolean | Signifies goal lineups are available for a sport event when true |
lineups_availability | sport_event - coverage - sport_event_properties | String | Describes the availability of lineups as pre-match or post-matchpre , post |
probabilities | sport_event - coverage - sport_event_properties | Boolean | Signifies probabilities are available for a sport event when true |
scores | sport_event - coverage - sport_event_properties | String | Describes the availability of scores as live or post-matchlive , post |
venue | sport_event - coverage - sport_event_properties | Boolean | Signifies venue info is available for a sport event when true |
Sport Event Situation:
Attribute | Parent Element | Type | Description |
---|---|---|---|
played | sport_event_status - clock | String | Match clock time in minutes90:00 |
stoppage_time_played | sport_event_status - clock | String | Stoppage time played in minutes5:49 |
stoppage_time_announced | sport_event_status - clock | String | Stoppage time announced in minutes5:00 |
status | sport_event_status - match_situation | String | Current situtation status of a matchsafe , dangerous , attack |
qualifier | sport_event_status - match_situation | String | Defines the team in the current situation statushome , away |
updated_at | sport_event_status - match_situation | Date-Time | Timestamp of the most recent match situation update ex. 2024-04-14T14:57:28+00:00 |
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 typeregular_period , overtime , penalties , pause , awaiting_extra , extra_time_halftime , interrupted |
Sport Event Status:
Attribute | Parent Element | Type | Description |
---|---|---|---|
aggregate_away_score | sport_event_status | Integer | Aggregate score (of multiple sport events) for the away team |
aggregate_home_score | sport_event_status | Integer | Aggregate score (of multiple sport events) for the home team |
aggregate_winner_id | sport_event_status | String | Unique ID of the aggregate score winner ex. sr:competitor:44 |
away_normaltime_score | sport_event_status | Integer | Score for the away team in normal time |
away_overtime_score | sport_event_status | Integer | Score for the away team in overtime |
away_score | sport_event_status | Integer | Total score for the away team in the match |
home_normaltime_score | sport_event_status | Integer | Score for the home team in normal time |
home_overtime_score | sport_event_status | Integer | Score for the home team in overtime |
home_score | sport_event_status | Integer | Total score for the home team in the 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 |
match_status | sport_event_status | String | Status within a match. Provides more detail on the state of a match when live than status ex. not_started , 2nd_half , ended , awaiting_penalties See our FAQ for a complete list of statuses and their definitions. |
match_tie | sport_event_status | Boolean | Signifies a match ended in a tie when true |
scount_abandoned | sport_event_status | Boolean | Signifies a match was abandoned by a scout when true |
status | sport_event_status | String | Status of a match ex. not_started , 2nd_half , ended , awaiting_penalties 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:44 |
Ball Location:
Visit our FAQ for additional information on ball location data.
Attribute | Parent Element | Type | Description |
---|---|---|---|
order | sport_event_status - ball_locations - ball_location | Integer | Sequential order of a ball location event. The most recent location is 4 and the oldest location is 1 . |
qualifier | sport_event_status - ball_locations - ball_location | String | Designation of a competitor for a ball location entryhome , away |
x | sport_event_status - ball_locations - ball_location | String | Horizontal X coordinate of the pitch. x is a number between 0 and 100 . The reference point 0 is at the home team’s goal. |
y | sport_event_status - ball_locations - ball_location | String | Vertical Y coordinate of the pitch. y is a number between 0 and 100 . The reference point 0 is on the top of the pitch where the home team’s goal is on the left hand side. |
Match Timeline:
Attribute | Parent Element | Type | Description |
---|---|---|---|
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 |
card_descriptoin | timeline - event | String | Description of the scenario during a card event ex. pre_match , half_time , post_match , player_on_bench , first_half , second_half , during_penalty_shootout |
text | timeline - event - commentary | String | Description of the scenario during a card event Commentary text description of a timeline event ex. Mario Hermoso (Atletico) has received a yellow card from Slavko Vincic. or It's a goal kick for the home team in Dortmund. |
competitor | timeline - event | String | Designation of a competitor for a timeline eventhome , away |
description | timeline - event | String | Description of an event. This data point is not currently in use |
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. 1721786685 |
injury_time_announced | timeline - event | Integer | Amount of injury time announced in minutes |
match_clock | timeline - event | String | Match clock value for a timeline event, in minutes and seconds ex. 89:37 |
match_time | timeline - event | Integer | Match clock value of a timeline event, in minutes ex. 89 |
method | timeline - event | String | Method of a scored goalpenalty , own_goal , header , shot , free_kick |
outcome | timeline - event | String | Outcome of a missed goalmiss , post , bar |
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. regular_period |
period_type | timeline - event | String | Period type of a timeline eventregular_period , overtime , penalties , pause , awaiting_extra , extra_time_halftime , interrupted |
shootout_away_score | timeline - event | Integer | Away team shootout score after a timeline event |
shootout_home_score | timeline - event | Integer | Home team shootout score after a timeline event |
shootout_home_score | timeline - event | Integer | Home team shootout score after a timeline event |
status | timeline - event | String | Status available during penalty shootouts (period_type="penalties" )ex. missed , scored , not_taken_yet |
stoppage_time | timeline - event | Integer | Stoppage time value for a timeline event ex. 3 |
stoppage_time_clock | timeline - event | String | Stoppage time clock value for a timeline event ex. 2:03 |
type | timeline - event | String | Type of timeline event. See our FAQ for a complete list of event types ex. goal_kick , period_start , yellow_card |
time | timeline - event | Date-time | Timestamp of a timeline event ex. 2024-04-16T20:49:49+00:00 |
x | timeline - event | Integer | Horizontal X coordinate of a timeline event. x is a number between 0 and 100 . The reference point 0 is at the home team’s goal. |
y | timeline - event | Integer | Vertical Y coordinate of a timeline event. y is a number between 0 and 100 . The reference point 0 is on the top of the pitch where the home team’s goal is on the left hand side. |
Player Event Details:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | event - player | String | Unique player Id associated with a timeline event ex. sr:player:2367105 |
name | event - player | String | Player name associated with a timeline event ex. Luna, Diego |
type | event - player | String | Player activity type associated with a timeline event. Signifies if a player scored a goal, recorded an assist, or participated in a substitution. ex. scorer , assist , substituted_in , substituted_out |
Match Stats (Player):
See our Extended Statistics FAQ for in-depth definitions of key data points
Attribute | Parent Element | Type | Description |
---|---|---|---|
assists | player - statistics | Integer | Player assists for a match |
chances_created | player - statistics | Integer | Player chances created for a match |
clearances | player - statistics | Integer | Player clearances for a match |
corner_kicks | player - statistics | Integer | Player corner kicks for a match |
crosses_successful | player - statistics | Integer | Player successful crosses for a match |
crosses_total | player - statistics | Integer | Player total crosses for a match |
defensive_blocks | player - statistics | Integer | Player defensive blocks for a match |
diving_saves | player - statistics | Integer | Player diving saves for a match |
dribbles_completed | player - statistics | Integer | Player dribbles completed for a match |
fouls_committed | player - statistics | Integer | Player fouls committed for a match |
goals_by_head | player - statistics | Integer | Player goals by head for a match |
goals_by_penalty | player - statistics | Integer | Player goals by penalty for a match |
goals_conceded | player - statistics | Integer | Player goals conceded for a match |
goals_scored | player - statistics | Integer | Player goals scored for a match |
interceptions | player - statistics | Integer | Player interceptions for a match |
long_passes_successful | player - statistics | Integer | Player successful long passes for a match |
long_passes_total | player - statistics | Integer | Player total long passes for a match |
long_passes_unsuccessful | player - statistics | Integer | Player unsuccessful long passes for a match |
loss_of_possession | player - statistics | Integer | Player possession losses for a match |
minutes_played | player - statistics | Integer | Player minutes played for a match |
offsides | player - statistics | Integer | Player offsides for a match |
own_goals | player - statistics | Integer | Player own goals for a match |
passes_successful | player - statistics | Integer | Player successful passes for a match |
passes_total | player - statistics | Integer | Player total passes for a match |
passes_unsuccessful | player - statistics | Integer | Player unsuccessful passes for a match |
penalties_faced | player - statistics | Integer | Player penalty shots faced for a match |
penalties_missed | player - statistics | Integer | Player penalty shots missed for a match |
penalties_saved | player - statistics | Integer | Player penalty shots saved for a match |
red_cards | player - statistics | Integer | Player red cards for a match |
shots_blocked | player - statistics | Integer | Player shots blocked for a match |
shots_faced_saved | player - statistics | Integer | Player shots saved for a match |
shots_faced_total | player - statistics | Integer | Player total shots faced for a match |
shots_off_target | player - statistics | Integer | Player shots off target for a match |
shots_on_target | player - statistics | Integer | Player shots on target for a match |
substituted_in | player - statistics | Integer | Signifies a player was substituted in during a match when 1 |
substituted_out | player - statistics | Integer | Signifies a player was substituted out during a match when 1 |
tackles_successful | player - statistics | Integer | Player successful tackles for a match |
tackles_total | player - statistics | Integer | Player total tackles for a match |
was_fouled | player - statistics | Integer | Number of fouls against a player in a match |
yellow_cards | player - statistics | Integer | Player yellow cards for a match |
yellow_red_cards | player - statistics | Integer | Player red cards for a match resulting from two yellow cards |
Match Stats (Team):
See our Extended Statistics FAQ for in-depth definitions of key data points
Attribute | Parent Element | Type | Description |
---|---|---|---|
ball_posession | competitor - statistics | Integer | Percentage of team ball possession for a match. ex. 43 |
cards_given | competitor - statistics | Integer | Total cards given to a team in a match |
chances_created | competitor - statistics | Integer | Total chances created for a team in a match |
clearances | competitor - statistics | Integer | Total clearances for a team in a match |
corner_kicks | competitor - statistics | Integer | Total team corner kicks for a match |
crosses_successful | competitor - statistics | Integer | Total successful crosses for a team in a match |
crosses_total | competitor - statistics | Integer | Total crosses for a team in a match |
crosses_unsuccessful | competitor - statistics | Integer | Total unsuccessful crosses for a team in a match |
defensive_blocks | competitor - statistics | Integer | Total team defensive blocks for a match |
diving_saves | competitor - statistics | Integer | Total team diving saves for a match |
fouls | competitor - statistics | Integer | Total number of fouls awarded against a team (including those which draw cards) |
free_kicks | competitor - statistics | Integer | Team free kicks for a match. In accordance with the rules, a free kick stat counted for the team who executes a free kick. Direct or indirect free kicks are all counted as free kicks. |
goal_kicks | competitor - statistics | Integer | Team goal kicks for a match. Total number of kicks awarded to the team as a result of the ball traveling out of bounds over the goal line of the defending team. |
injuries | competitor - statistics | Integer | Total team injuries for a match |
interceptions | competitor - statistics | Integer | Total team interceptions for a match |
long_passes_successful | competitor - statistics | Integer | Total successful long passes for a team in a match |
long_passes_total | competitor - statistics | Integer | Total long passes for a team in a match |
long_passes_unsuccessful | competitor - statistics | Integer | Total unsuccessful long passes for a team in a match |
offsides | competitor - statistics | Integer | Total team offside infringements for a match |
passes_successful | competitor - statistics | Integer | Total successful passes for a team in a match |
passes_total | competitor - statistics | Integer | Total passes for a team in a match |
passes_unsuccessful | competitor - statistics | Integer | Total unsuccessful passes for a team in a match |
penalties_missed | competitor - statistics | Integer | Total team penalty shots missed for a match |
red_cards | competitor - statistics | Integer | Total team red cards for a match |
shots_blocked | competitor - statistics | Integer | Total team shots blocked for a match |
shots_off_target | competitor - statistics | Integer | Total team off-target shots for a match |
shots_on_target | competitor - statistics | Integer | Total team on-target shots for a match |
shots_saved | competitor - statistics | Integer | Total number of goal keeper saves attributed to a team for a match |
shots_total | competitor - statistics | Integer | Total number of shots attributed to a team for a match |
substitutions | competitor - statistics | Integer | Total number player subsitutions in a match |
tackles_successful | competitor - statistics | Integer | Total successful tackles for a team in a match |
tackles_total | competitor - statistics | Integer | Total tackles for a team in a match |
tackles_unsuccessful | competitor - statistics | Integer | Total unsuccessful tackles for a team in a match |
throw_ins | competitor - statistics | Integer | Total number of throw-in events for a team during a match |
was_fouled | competitor - statistics | Integer | Number of fouls against a team in a match |
yellow_cards | competitor - statistics | Integer | Total team yellow cards for a match |
yellow_red_cards | competitor - statistics | Integer | Total team red cards for a match which resulted from two yellow cards |
Venue:
Attribute | Parent Element | Type | Description |
---|---|---|---|
capacity | venue | Integer | Capacity of a venue ex. 60000 |
changed | venue | Boolean | Signifies a venue has been changed when true |
city_name | venue | String | City name of a venue ex. Liverpool |
country_code | venue | String | Country code of a venue ex. ENG (England) |
country_name | venue | String | Country name of a venue ex. England |
id | venue | String | Unique ID of a venue ex. sr:venue:579 |
map_coordinates | venue | String | Coordinates of a venue ex. 53.430622,-2.960919 |
name | venue | String | Name of a venue ex. Anfield |
reduced_capacity | venue | Boolean | Optional attribute signifying a venue has a restricted capacity when true |
reduced_capacity_max | venue | Integer | Value of a venue's restricted capacity |
timezone | venue | String | Timezone of a venue ex. Europe/London |