Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Competitor vs Competitor

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:
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a sport event's category
ex. RUS (Russia)
idsport_event_context - categoryStringUnique category ID for a sport event
ex. sr:category:101
namesport_event_context - categoryStringName for a sport event's category
ex. Russia
idsport_event_context - sportStringUnique sport ID for a sport event
sr:sport:4
namesport_event_context - sportStringName for a sport event's sport
Ice Hockey
Competition:
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition
men, women
idsport_event_context - competitionStringUnique ID for a competition
ex. sr:competition:268 (KHL)
namesport_event_context - competitionStringName of a competition
ex. KHL, World Championship, Swiss League
parent_idsport_event_context - competitionStringUnique parent ID for a competition. Typically present for group competitions
ex. sr:competition:23983 used to group NCAA Men's postseason tournaments.
Groups:
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group
ex. sr:league:83925 (KHL 24/25, Chernyshev Division)
namesport_event_context - groups - groupStringName of a sport event's group
ex. KHL 24/25, KHL 24/25, Chernyshev Division
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
ex. Chernyshev Division
Rounds:
AttributeParent ElementTypeDescription
competition_sport_event_numbersport_event_context - roundIntegerSport event number within a competition. Used for competitions that have fixed match numbers.
cup_round_idsport_event_context - roundStringUnique ID for a sport event's cup round
ex. sr:cup_round:2091593
cup_round_number_of_sport_eventssport_event_context - roundIntegerNumber of events in a sport event's round
cup_round_sport_event_numbersport_event_context - roundIntegerNumber within the cup_round of a match ID. For example, 1st leg of 2
namesport_event_context - roundStringName of a sport event's round
ex. quarterfinal, round_1
numbersport_event_context - roundIntegerNumber of a sport event's round
other_sport_event_idsport_event_context - roundStringA linked sport event ID, typically in a two-legged tie
ex. sr:sport_event:47395897
Seasons:
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a sport event belongs to
ex. sr:competition:268 (KHL)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a sport event's season
ex. 2025-05-25
idsport_event_context - seasonStringUnique ID for a sport event's season
ex. sr:season:119485 (KHL 24/25)
namesport_event_context - seasonStringName of a sport event's season
ex. KHL 24/25
start_datesport_event_context - seasonDateStart date of a sport event's season
ex. 2024-09-03
yearsport_event_context - seasonStringYear of a sport event's season
ex. 24/25
Stages:
AttributeParent ElementTypeDescription
end_datesport_event_context - stageDateEnd date of a sport event's stage
ex. 2024-02-11
ordersport_event_context - stageIntegerOrder of a stage within a season
phasesport_event_context - stageStringName 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_datesport_event_context - stageDateStart date of a sport event's stage
ex. 2024-01-13
typesport_event_context - stageStringType of a sport event's stage
cup, league
yearsport_event_context - stageStringYear 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.

AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name
ex. OMS (HK Avangard Omsk)
age_groupcompetitors - competitorStringAge group of a competitor, when applicable
ex. U23
countrycompetitors - competitorStringCountry of a competitor
ex. Russia
country_codecompetitors - competitorStringCountry code of a competitor
ex. RUS (Russia)
gendercompetitors - competitorStringGender for a competitor
male, female
idcompetitors - competitor`StringUnique ID for a competitor
ex. sr:competitor:3945 (HK Avangard Omsk)
namecompetitors - competitorStringName for a competitor
ex. HK Avangard Omsk
qualifiercompetitors - competitorStringDesignation of a competitor for a sport event
home, away
virtualcompetitors - competitorBooleanSignifies a competitor is a virtual team whan true. Used for placeholder teams in TBD vs TBD matchups.
Player:
AttributeParent ElementTypeDescription
idstatistics - competitor - playerStringUnique ID of a player
ex. sr:player:87951
namestatistics - competitor - playerStringName of a player
ex. Proskuryakov, Ilya
Sport Event:
AttributeParent ElementTypeDescription
neutralsport_event_conditions - groundBooleanSignifies a neutral ground sport event when true
idsport_eventStringUnique ID of a sport event
ex. sr:sport_event:50707985
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date
ex. sr:sport_event:46791659
resume_timesport_eventDateAn updated timestamp if there is a delay at the start or interruption during a match
ex. 2024-03-26T20:00:00+00:00
start_timesport_eventDateStart time of a sport event
ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a sport event is confirmed when true
Sport Event - Coverage Properties:
AttributeParent ElementTypeDescription
typesport_event - coverageStringType of coverage
sport_event, group, competition
basic_play_by_playsport_event - coverage - sport_event_propertiesBooleanSignifies basic play-by-play is available for a sport event when true
basic_player_statssport_event - coverage - sport_event_propertiesBooleanSignifies basic player stats is available for a sport event when true
basic_team_statssport_event - coverage - sport_event_propertiesBooleanSignifies basic team stats is available for a sport event when true
deeper_player_statssport_event - coverage - sport_event_propertiesBooleanSignifies deeper player stats is available for a sport event when true
deeper_team_statssport_event - coverage - sport_event_propertiesBooleanSignifies deeper team stats is available for a sport event when true
goal_scorerssport_event - coverage - sport_event_propertiesBooleanSignifies goal scorers are available for a sport event when true
lineupssport_event - coverage - sport_event_propertiesBooleanSignifies goal lineups are available for a sport event when true
scoressport_event - coverage - sport_event_propertiesStringDescribes the availability of scores as live or post-match
live, post
Period Scores:
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway team period score
home_scoresport_event_status - period_scores - period_scoreIntegerHome team period score
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod type
regular_period, overtime, 1st_period, 1st_pause, 2nd_period, 2nd_pause, 3rd_period, awaiting_extra, awaiting_penalties, penalties, interrupted
Sport Event Status:
AttributeParent ElementTypeDescription
aggregate_away_scoresport_event_statusIntegerAggregate score (of multiple sport events) for the away team
aggregate_home_scoresport_event_statusIntegerAggregate score (of multiple sport events) for the home team
aggregate_winner_idsport_event_statusStringUnique ID of the aggregate score winner
ex. sr:competitor:3945
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time
away_scoresport_event_statusIntegerTotal score for the away team in the game
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time
home_scoresport_event_statusIntegerTotal score for the home team in the game
decided_by_fedsport_event_statusBooleanSignifies a match result was decided by the federation when true. For example, incomplete due to crowd disruption
match_statussport_event_statusStringStatus 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_abandonedsport_event_statusBooleanSignifies a match was abandoned by a scout when true
statussport_event_statusStringStatus of a match
ex. not_started, live, ended, closed

See our FAQ for a complete list of statuses and their definitions.
winner_idsport_event_statusStringUnique ID of the match winner
ex. sr:competitor:3950
Game Stats (Player):
AttributeParent ElementTypeDescription
assistsplayer - statisticsIntegerNumber of assists for a player in a game
first_assistsplayer - statisticsIntegerNumber of first assists for a player in a game
goalie_minutes_playedplayer - statisticsIntegerNumber of minutes played for a goalie in a game
goalsplayer - statisticsIntegerNumber of goals for a player in a game
penaltiesplayer - statisticsIntegerNumber of penalties for a player in a game
penalty_minutesplayer - statisticsIntegerNumber of penalty minutes for a player in a game
plus_minusplayer - statisticsIntegerPlus/minus value for a player in a game
pointsplayer - statisticsIntegerNumber of points for a player in a game
savesplayer - statisticsIntegerNumber of saves for a goalie in a game
second_assistsplayer - statisticsIntegerNumber of second assists for a player in a game
shots_on_goalplayer - statisticsIntegerNumber of shots on goal for a player in a game
Game Stats (Team):
AttributeParent ElementTypeDescription
goals_concededcompetitor - statisticsIntegerNumber of goals allowed for a team in a game
goals_in_power_playcompetitor - statisticsIntegerNumber of power play goals scored for a team in a game
goals_while_short_handedcompetitor - statisticsIntegerNumber of short-handed goals scored for a team in a game
penaltiescompetitor - statisticsIntegerNumber of penalties for a team in a game
penalty_minutescompetitor - statisticsIntegerNumber of penalty minutes for a team in a game
power_playscompetitor - statisticsIntegerNumber of power plays for a team in a game
puck_possessioncompetitor - statisticsIntegerNumber of puck possessions for a team in a game
savescompetitor - statisticsIntegerNumber of saves for a team in a game
shots_on_goalcompetitor - statisticsIntegerNumber of shots on goal for a team in a game
shutoutscompetitor - statisticsIntegerSignifies a shutout for a team in a game when 1
Venue:
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue
ex. 12000
city_namevenueStringCity name of a venue
ex. Omsk
country_codevenueStringCountry code of a venue
ex. RUS (Russia)
country_namevenueStringCountry name of a venue
ex. Russia
idvenueStringUnique ID of a venue
ex. sr:venue:66577
map_coordinatesvenueStringCoordinates of a venue
ex. 55.00738,73.294823
namevenueStringName of a venue
ex. G-Drive Arena
reduced_capacityvenueBooleanOptional attribute signifying a venue has a restricted capacity when true
reduced_capacity_maxvenueIntegerValue of a venue's restrictued capacity
timezonevenueStringTimezone of a venue
ex. Asia/Omsk
Language
Credentials
Query
Click Try It! to start a request and see the response here!