⏱️
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. `DEU` (Germany)
`id`	`sport_event_context` - `category`	String	Unique category ID for a sport event ex. `sr:category:53`
`name`	`sport_event_context` - `category`	String	Name for a sport event's category ex. `Germany`
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a sport event ex. `sr:sport:6`
`name`	`sport_event_context` - `sport`	String	Name for a sport event's sport ex. `Handball`

Competition

Attribute	Parent Element	Type	Description
`gender`	`sport_event_context` - `competition`	String	Gender for a competition `men`, `women`
`id`	`sport_event_context` - `competition`	String	Unique ID for a competition ex. `sr:competition:161` (Handbollsligan)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `Handbollsligan`
`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.

Coverage Properties

Attribute	Parent Element	Type	Description
`type`	`sport_event` - `coverage`	String	Type of coverage for a sport event `sport_event`, `competition`
`basic_play_by_play`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies basic play-by-play is available for a group when `true`
`basic_player_stats`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies basic player stats is available for a group when `true`
`basic_team_stats`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies basic team stats is available for a group when `true`
`goal_scorers`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies goal scorers are available for a group when `true`
`lineups`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies goal lineups are available for a group when `true`
`scores`	`sport_event` - `coverage` - `sport_event_properties`	String	Describes the availability of scores as live or post-match `live`, `post`

Groups

Attribute	Parent Element	Type	Description
`id`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:league:83057` (Olympic Tournament 2024, Group A)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `Olympic Tournament 2024, Group A`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `A`

Rounds

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.
`cup_round_id`	`sport_event_context` - `round`	String	Unique ID for a sport event's cup round ex. `sr:cup_round:2029419`
`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. `quarterfinal` or `final`
`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`

Seasons

Attribute	Parent Element	Type	Description
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:160` (EHF Euro)
`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 season ex. `2024-11-03`
`id`	`sport_event_context` - `season`	String	Unique ID for a season ex. `sr:season:105127` (EHF Euro 2024)
`name`	`sport_event_context` - `season`	String	Name of a season ex. `EHF Euro 2024`
`start_date`	`sport_event_context` - `season`	Date	Start date of a season ex. `2024-03-29`
`year`	`sport_event_context` - `season`	String	Year of a season ex. `23/24` or `2024`

Stages

Attribute	Parent Element	Type	Description
`end_date`	`sport_event_context` - `stage`	Date	End date of a sport event's stage ex. `2024-10-01`
`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`, `qualification`, `playoffs` See the enum_phase entry in our Handball OpenAPI spec for a complete list of valid `phase` enum values
`start_date`	`sport_event_context` - `stage`	Date	Start date of a sport event's stage ex. `2024-03-20`
`type`	`sport_event_context` - `stage`	String	Type of a sport event's stage `cup`, `league`
`year`	`sport_event_context` - `stage`	String	Year of a sport event's stage ex. `23/24` or `2024`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `RNL` (Rhein-Neckar Lowen)
`age_group`	`competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `Germany`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `DEU` (Germany)
`gender`	`competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:4004` (Rhein-Neckar Lowen)
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Rhein-Neckar Lowen`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a season `home`, `away`
`virtual`	`competitors` - `competitor`	Boolean	Signifies a competitor is a virtual team when `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: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`
`count_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 Stats (Team)

Attribute	Parent Element	Type	Description
`assists`	`competitor` - `statistics`	Integer	Total team assists for a match
`blocks`	`competitor` - `statistics`	Integer	Total team blocks for a match
`field_goals`	`competitor` - `statistics`	Integer	Total team field goals for a match
`goals_conceded`	`competitor` - `statistics`	Integer	Total team goals conceded for a match
`goals_scored`	`competitor` - `statistics`	Integer	Total team goals scored for a match
`red_cards`	`competitor` - `statistics`	Integer	Total team red cards for a match
`saves`	`competitor` - `statistics`	Integer	Total team saves for a match
`seven_m_goals`	`competitor` - `statistics`	Integer	Total team 7-meter throw goals for a match
`shot_accuracy`	`competitor` - `statistics`	Float	Team shot accuracy percentage for a match ex. `63.04`
`shots`	`competitor` - `statistics`	Integer	Total team shots for a match
`shots_against`	`competitor` - `statistics`	Integer	Total team shots against for a match
`shots_off_goal`	`competitor` - `statistics`	Integer	Total team shots off goal for a match
`shots_on_goal`	`competitor` - `statistics`	Integer	Total team shots on goal for a match
`steals`	`competitor` - `statistics`	Integer	Total team steals for a match
`suspensions`	`competitor` - `statistics`	Integer	Total team suspensions for a match
`technical_fouls`	`competitor` - `statistics`	Integer	Total team technical fouls for a match
`yellow_cards`	`competitor` - `statistics`	Integer	Total team yellow cards for a match

Match Stats (Player)

Attribute	Parent Element	Type	Description
`assists`	`player` - `statistics`	Integer	Player assists for a match
`blocks`	`player` - `statistics`	Integer	Player blocks for a match
`field_goals`	`player` - `statistics`	Integer	Player field goals for a match
`goalkeeper_minutes_played`	`player` - `statistics`	String	Number of minutes played for a goalkeeper in a match ex. `34:03`
`goals_conceded`	`player` - `statistics`	Integer	Number of goals conceded for a goalkeeper in a match
`goals_scored`	`player` - `statistics`	Integer	Player goals scored for a match
`red_cards`	`player` - `statistics`	Integer	Player red cards for a match
`save_accuracy`	`player` - `statistics`	Float	Save percentage for a goalkeeper in a match ex. `34.78`
`saves`	`player` - `statistics`	Integer	Number of saves for a goalkeeper in a match
`seven_m_goals`	`player` - `statistics`	Integer	Player 7-meter goals for a match
`seven_m_saves`	`player` - `statistics`	Integer	Player 7-meter throw saves in a match
`shot_accuracy`	`player` - `statistics`	Float	Player shot accuracy percentage for a match ex. `63.04`
`shots`	`player` - `statistics`	Integer	Player shots for a match
`shots_against`	`player` - `statistics`	Integer	Number of shots against for a goalkeeper in a match
`shots_off_goal`	`player` - `statistics`	Integer	Player shots off goal for a match
`shots_on_goal`	`player` - `statistics`	Integer	Player shots on goal for a match
`steals`	`player` - `statistics`	Integer	Player steals for a match
`suspensions`	`player` - `statistics`	Integer	Player suspensions for a match
`technical_fouls`	`player` - `statistics`	Integer	Player technical fouls for a match
`yellow_cards`	`player` - `statistics`	Integer	Player yellow cards for a match

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`
`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` - `assists` / `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`

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `13200`
`changed`	`venue`	Boolean	Signifies a venue has been changed when `true`
`city_name`	`venue`	String	City name of a venue ex. `Mannheim`
`country_code`	`venue`	String	Country code of a venue ex. `DEU`
`country_name`	`venue`	String	Country name of a venue ex. `Germany`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:2010`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `49.463730,8.517570`
`name`	`venue`	String	Name of a venue ex. `SAP Arena`
`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/Berlin`