⏱️
Update Frequency
30s 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. RUS (Russia) | | id | sport_event_context - category | String | Unique category ID for a sport event

ex. sr:category:101 | | name | sport_event_context - category | String | Name for a sport event's category

ex. Russia | | id | sport_event_context - sport | String | Unique sport ID for a sport event

sr:sport:4 | | name | sport_event_context - sport | String | Name for a sport event's sport

Ice Hockey |

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:268` (KHL)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `KHL`, `World Championship`, `Swiss League`
`parent_id`	`sport_event_context` - `competition`	String	Unique parent ID for a competition. Typically present for group competitions ex. `sr:competition:23983` used to group NCAA Men's postseason tournaments.

Groups

Attribute	Parent Element	Type	Description
`id`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:league:83925` (KHL 24/25, Chernyshev Division)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `KHL 24/25`, `KHL 24/25, Chernyshev Division`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `Chernyshev Division`

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:2091593`
`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`, `round_1`
`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 sport event belongs to ex. `sr:competition:268` (KHL)
`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 sport event's season ex. `2025-05-25`
`id`	`sport_event_context` - `season`	String	Unique ID for a sport event's season ex. `sr:season:119485` (KHL 24/25)
`name`	`sport_event_context` - `season`	String	Name of a sport event's season ex. `KHL 24/25`
`start_date`	`sport_event_context` - `season`	Date	Start date of a sport event's season ex. `2024-09-03`
`year`	`sport_event_context` - `season`	String	Year of a sport event's season ex. `24/25`

Stages

Attribute	Parent Element	Type	Description
`end_date`	`sport_event_context` - `stage`	Date	End date of a sport event's stage ex. `2024-02-11`
`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`, `conference`, `playoffs` See the enum_phase entry in our Global Ice Hockey 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-01-13`
`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. `24/25`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `OMS` (HK Avangard Omsk)
`age_group`	`competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `Russia`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `RUS` (Russia)
`gender`	`competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:3945` (HK Avangard Omsk)
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `HK Avangard Omsk`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a sport event `home`, `away`
`virtual`	`competitors` - `competitor`	Boolean	Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups.

Jersey

Attribute	Parent Element	Type	Description
`base`	`competitor` - `jersey`	String	RGB color code of a competitor's base jersey ex. `a21010`
`horizontal_stripes`	`competitor` - `jersey`	Boolean	Signifies a competitor's jersey has horizontal stripes when `true`
`number`	`competitor` - `jersey`	String	RGB color code of a competitor's jersey number ex. `f4f4f0`
`shirt_type`	`competitor` - `jersey`	String	Shirt type of a competitor's jersey ex. `long_sleeves`
`sleeve`	`competitor` - `jersey`	String	RGB color code of a competitor's jersey sleeves ex. `000000`
`split`	`competitor` - `jersey`	Boolean	Signifies a competitor's jersey is split when `true`
`squares`	`competitor` - `jersey`	Boolean	Signifies a competitor's jersey is squares when `true`
`stripes`	`competitor` - `jersey`	Boolean	Signifies a competitor's jersey has stripes when `true`
`type`	`competitor` - `jersey`	String	Type of competitor jersey entry ex. `home`, `away`, `third`

Manager

Attribute	Parent Element	Type	Description
`country_code`	`competitor` - `manager`	String	Country code of a manager ex. `USA` (United States)
`date_of_birth`	`competitor` - `manager`	Date	Date of birth of a manager ex. `1968-02-27`
`gender`	`competitor` - `manager`	String	Gender of a manager `male`, `female`
`id`	`competitor` - `manager`	String	Unique ID of a manager ex. `sr:player:985139`
`name`	`competitor` - `manager`	String	Name of a manager ex. `Sullivan, Mike`
`nationality`	`competitor` - `manager`	String	Nationality of a manager ex. `United states`
`nickname`	`competitor` - `manager`	String	Nickname of a manager

Player

Attribute	Parent Element	Type	Description
`country_code`	`competitor` - `player`	String	Country code of a player ex. `USA` (United States)
`date_of_birth`	`competitor` - `player`	Date	Date of birth of a player ex. `2000-02-25`
`height`	`competitor` - `player`	Integer	Height of a player in centimeters ex. `180`
`id`	`competitor` - `player`	String	Unique ID of a player ex. `sr:player:1692885`
`jersey_number`	`competitor` - `player`	Integer	Jersey number of a player
`name`	`competitor` - `player`	String	Name of a player ex. `Proskuryakov, Ilya`
`nationality`	`competitor` - `player`	String	Nationality of a player ex. `Russian federation`
`nickname`	`competitor` - `player`	String	Nickname of a player
`played`	`player`	Boolean	Signifies a player appeared in a game when `true` We do not currently differentiate between `starter` and `played` in the Global Ice Hockey API.
`type`	`competitor` - `player`	String	Position of a player See the enum_player_type entry in our Open API Spec for a complete list of player positions ex. `F`, `D`, `LW`, `C`
`starter`	`player`	Boolean	Signifies a player is in the starting lineup of a match when `true` We do not currently differentiate between `starter` and `played` in the Global Ice Hockey API.
`weight`	`competitor` - `player`	Integer	Weight of a player in kilograms ex. `78`

Sport Event

Attribute	Parent Element	Type	Description
`neutral`	`sport_event_conditions` - `ground`	Boolean	Signifies a neutral ground sport event when `true`
`id`	`sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:50707985`
`replaced_by`	`sport_event`	String	An alternative sport event ID if the match is postponed and played at a later date ex. `sr:sport_event:46791659`
`resume_time`	`sport_event`	Date	An updated timestamp if there is a delay at the start or interruption during a match ex. `2024-03-26T20:00:00+00:00`
`start_time`	`sport_event`	Date	Start time of a sport event ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies the start time of a sport event is confirmed when `true`

Sport Event - Coverage Properties

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

Period Scores

Attribute	Parent Element	Type	Description
`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`, `1st_period`, `1st_pause`, `2nd_period`, `2nd_pause`, `3rd_period`, `awaiting_extra`, `awaiting_penalties`, `penalties`, `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:3945`
`away_normaltime_score`	`sport_event_status`	Integer	Score for the away team in normal time
`away_score`	`sport_event_status`	Integer	Total score for the away team in the game
`home_normaltime_score`	`sport_event_status`	Integer	Score for the home team in normal time
`home_score`	`sport_event_status`	Integer	Total score for the home team in the game
`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`, `1st_period`, `1st_extra`, `awaiting_extra_time` See our FAQ for a complete list of statuses and their definitions.
`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:3950`

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `12000`
`city_name`	`venue`	String	City name of a venue ex. `Omsk`
`country_code`	`venue`	String	Country code of a venue ex. `RUS` (Russia)
`country_name`	`venue`	String	Country name of a venue ex. `Russia`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:66577`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `55.00738,73.294823`
`name`	`venue`	String	Name of a venue ex. `G-Drive 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. `Asia/Omsk`