Live Timelines Delta

get https://api.sportradar.com/handball/{access_level}/v2/{language_code}/schedules/live/timelines_delta.{format}

Provides a 10 second live delta of game information, including scoring and a play-by-play event timeline.

⏱️
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:2300047`
`name`	`statistics` - `competitor` - `player`	String	Name of a player ex. `Grupe, Magnus`

Period Scores:

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away team inning score
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home team inning 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`, `awaiting_penalties`, `1st_half`, `2nd_half`, `pause`, `1st_extra`, `2nd_extra`, `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 Handball OpenAPI under enum_sport_event_match_status for a complete list of statuses
`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`, `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:7578`

Match Timeline:

Attribute	Parent Element	Type	Description
`id`	`sport_event_timeline_delta`	String	Unique Id of a sport event ex. `sr:sport_event:51614749`
`start_time`	`sport_event_timeline_delta`	Date-time	Start time of a sport event ex. `2024-08-06T15:30: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 event `home`, `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. `1793543391`
`match_clock`	`timeline` - `event`	String	Time elapsed in a game for a timeline event, in minutes and seconds ex. `29:42`
`match_time`	`timeline` - `event`	Integer	Time elapsed in a game for a timeline event, in minutes ex. `30`
`method`	`timeline` - `event`	String	Method of a scored goal ex. `penalty`
`period`	`timeline` - `event`	Integer	Period number of a timeline event
`period_name`	`timeline` - `event`	String	Name of a period timeline event, appearing at the beginning of a period ex. `2nd_half`
`period_type`	`timeline` - `event`	String	Period type of a timeline event ex. `regular_period`
`shot_type`	`timeline` - `event`	String	Type of shot for a timeline event ex. `fast_break`, `breakthrough`, `direct_free_throw`, `pivot`
`suspension_minutes`	`timeline` - `event`	Integer	Number of suspension minutes charged to a player in a timeline event
`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 Handball OpenAPI under enum_event_type for a complete list of event types. ex. `match_started`, `match_ended`, `period_start`, `break_start`, `score_change`, `seven_m_awarded`
`zone`	`timeline` - `event`	String	Type of timeline event. See our Handball OpenAPI under enum_zone_type for a complete list of event types. ex. `wing_left`, `nine_meter_centre`, `back_court`

Player Event Details:

Attribute	Parent Element	Type	Description
`id`	`event` - `scorer`	String	Unique player Id associated with a scoring event ex. `sr:player:2300047`
`name`	`event` - `scorer`	String	Player name associated with a scoring event ex. `Grupe, Magnus`
`id`	`event` - `players` - `player`	String	Unique player Id associated with a timeline event ex. `sr:player:2300047`
`name`	`event` - `players` - `player`	String	Player name associated with a timeline event ex. `Grupe, Magnus`
`id`	`event` - `assists` - `player`	String	Unique player Id credited with an assist for a timeline event ex. `sr:player:2300047`
`name`	`event` - `assists` - `player`	String	Player name credited with an assist for a timeline event ex. `Grupe, Magnus`
`type`	`event` - `assist` / `players` - `player`	String	Player activity type associated with a timeline event. Signifies if a player scored a goal, surrendered a goal, recorded an assist, or participated in a substitution. ex. `shot`, `saved`, `goalkeeper`, `primary` (assist), `substituted_out`, `substituted_in`

Language

Credentials

Query

Click Try It! to start a request and see the response here!