Live Timelines Delta

Time	Status	User Agent
Retrieving recent requests…

⏱️
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 minutes `90:00`
`stoppage_time_played`	`sport_event_status` - `clock`	String	Stoppage time played in minutes `5:49`
`stoppage_time_announced`	`sport_event_status` - `clock`	String	Stoppage time announced in minutes `5:00`
`status`	`sport_event_status` - `match_situation`	String	Current situation status of a match `safe`, `dangerous`, `attack`
`qualifier`	`sport_event_status` - `match_situation`	String	Defines the team in the current situation status `home`, `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 type `regular_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`
`scout_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`, `live`, `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 entry `home`, `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_delta`	String	Unique Id of a sport event ex. `sr:sport_event:46377483`
`start_time`	`sport_event_timeline_delta`	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_description`	`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 event `home`, `away`
`decision`	`timeline` - `event`	String	Decision of a VAR timeline event `pending`, `cancelled`, `upheld`, `overturned` Not currently supported
`description`	`timeline` - `event`	String	Result of a VAR timeline event `goal`, `penalty`, `red_card`, `no_goal`, `no_penalty`, `no_red_card`, `corner`, `no_corner`, `mistaken_identity`, `no_mistaken_identity`
`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
`late`	`league_timeline` - `event`	Boolean	Indicates the incoming substitute was temporarily prevented from entering the field because the replaced player did not leave the field within the time allowed. When `true`, the team briefly plays with one fewer player before the substitution is completed.
`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 goal `penalty`, `own_goal`, `header`, `shot`, `free_kick`, `corner`
`outcome`	`timeline` - `event`	String	Outcome of a missed goal `miss`, `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 event `regular_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	UTC timestamp indicating when the timeline event was created or most recently updated in our system. This reflects system processing time, not the time the event occurred on the pitch. The timestamp may lag behind the actual event—typically by a short interval during live play, or by minutes to hours for later additions and corrections. When the record is first created, this value reflects its creation time. If the record is later updated, the value is replaced with the latest update time and no longer preserves the original creation time. 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`

Update Frequency

Data Points

200200