get https://api.sportradar.com/icehockey//v2//competitors//versus//summaries.
Global Hockey Competitor vs Competitor provides previous and upcoming games between two teams, including scoring information.
Update Frequency
60s 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 eventsr:sport:4 |
name | sport_event_context - sport | String | Name for a sport event's sportIce Hockey |
Competition:
Attribute | Parent Element | Type | Description |
---|---|---|---|
gender | sport_event_context - competition | String | Gender for a competitionmen , 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 stagecup , league |
year | sport_event_context - stage | String | Year of a sport event's stage ex. 24/25 |
Competitor:
Competitor info is available at the top of each file and for each individual game.
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 competitormale , 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 eventhome , away |
virtual | competitors - competitor | Boolean | Signifies a competitor is a virtual team whan 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:87951 |
name | statistics - competitor - player | String | Name of a player ex. Proskuryakov, Ilya |
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 coveragesport_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-matchlive , 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 typeregular_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 |
Game Stats (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
assists | player - statistics | Integer | Number of assists for a player in a game |
first_assists | player - statistics | Integer | Number of first assists for a player in a game |
goalie_minutes_played | player - statistics | Integer | Number of minutes played for a goalie in a game |
goals | player - statistics | Integer | Number of goals for a player in a game |
penalties | player - statistics | Integer | Number of penalties for a player in a game |
penalty_minutes | player - statistics | Integer | Number of penalty minutes for a player in a game |
plus_minus | player - statistics | Integer | Plus/minus value for a player in a game |
points | player - statistics | Integer | Number of points for a player in a game |
saves | player - statistics | Integer | Number of saves for a goalie in a game |
second_assists | player - statistics | Integer | Number of second assists for a player in a game |
shots_on_goal | player - statistics | Integer | Number of shots on goal for a player in a game |
Game Stats (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
goals_conceded | competitor - statistics | Integer | Number of goals allowed for a team in a game |
goals_in_power_play | competitor - statistics | Integer | Number of power play goals scored for a team in a game |
goals_while_short_handed | competitor - statistics | Integer | Number of short-handed goals scored for a team in a game |
penalties | competitor - statistics | Integer | Number of penalties for a team in a game |
penalty_minutes | competitor - statistics | Integer | Number of penalty minutes for a team in a game |
power_plays | competitor - statistics | Integer | Number of power plays for a team in a game |
puck_possession | competitor - statistics | Integer | Number of puck possessions for a team in a game |
saves | competitor - statistics | Integer | Number of saves for a team in a game |
shots_on_goal | competitor - statistics | Integer | Number of shots on goal for a team in a game |
shutouts | competitor - statistics | Integer | Signifies a shutout for a team in a game when 1 |
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 restrictued capacity |
timezone | venue | String | Timezone of a venue ex. Asia/Omsk |