get https://api.sportradar.com/handball//v2//schedules/live/timelines.
Provides a real-time play-by-play event timeline for currently live games.
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 typeregular_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 statusex. not_started, 2nd_half, ended, awaiting_penaltiesSee 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, closedSee 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 | String | Unique Id of a sport event ex. sr:sport_event:51614749 |
start_time | sport_event_timeline | 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 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. 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 |