Provides a play-by-play event timeline for currently live matches. Matches appear a few minutes before kick-off and disappear a few minutes after the match reaches “ended” status.
Update Frequency
1s Time To Live / Cache
Data Points
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 |
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:
| 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 |
|---|---|---|---|
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 |
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 |