Skip to main content
Version: 0.1.5

NHL — NHL Records API — Coach

nhl_records_coach_career​

Coach career-records (regular season).

Endpoint URL: GET https://records.nhl.com/site/api/coach-career-records/{coach_id}

Valid URL: https://records.nhl.com/site/api/coach-career-records

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_id path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idintegerUnique player identifier.
active_coachlogicalIndicates whether the coach is currently active as an NHL head coach.
coach_namecharacterFull display name of the NHL head coach.
end_seasonintegerThe most recent season the coach held a head-coaching position, encoded as an eight-digit season ID.
first_namecharacterPlayer first name.
game_type_idintegerGame type identifier (regular/playoffs).
gamesintegerGames played.
home_gamesinteger
home_lossesintegerLosses at home.
home_ot_lossesdoubleHome overtime losses.
home_tiesdoubleTies at home.
home_win_pctgdoubleWin percentage for all regular-season home games coached.
home_winsintegerWins at home.
jack_adamsintegerNumber of Jack Adams Award trophies won by the coach as NHL coach of the year.
last_coached_datecharacterDate of the coach's most recent game on the bench, in ISO 8601 format.
last_namecharacterPlayer last name.
lossesintegerLosses.
losses_in_otintegerTotal regular-season games the coach's team lost in overtime.
losses_in_ot_plus_shootoutintegerTotal regular-season games the coach's team lost in overtime or a shootout combined.
losses_in_shootoutdoubleTotal regular-season games the coach's team lost via shootout.
ot_lossesdoubleOvertime losses.
road_gamesintegerTotal regular-season road games coached.
road_lossesintegerLosses on the road.
road_ot_lossesdoubleRoad overtime losses.
road_tiesdoubleTies on the road.
road_win_pctgdoubleWin percentage for all regular-season road games coached.
road_winsintegerWins on the road.
seasonsintegerNumber of NHL seasons the coach has served as a head coach.
stanley_cup_final_appearancesintegerNumber of times the coach has led a team to the Stanley Cup Final.
stanley_cupsintegerNumber of Stanley Cup championships won as head coach.
start_seasonintegerThe first season the coach served as an NHL head coach, encoded as an eight-digit season ID.
team_abbrevscharacterTeam abbreviation(s).
tiesdoubleTotal ties.
ties_in_otintegerTotal regular-season overtime-period ties recorded under pre-shootout rules.
win_pctgdoubleOverall regular-season win percentage across the coach's entire career.
winsintegerWins.
wins_in_otintegerTotal regular-season games the coach's team won in overtime.
wins_in_ot_plus_shootoutintegerTotal regular-season games the coach's team won in overtime or a shootout combined.
wins_in_shootoutdoubleWins in shootout.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nhl_records_coach_career()

Last validated n/a.

nhl_records_coach_career_with_playoffs​

Coach career records inclusive of regular season + playoffs.

Endpoint URL: GET https://records.nhl.com/site/api/coach-career-records-regular-plus-playoffs

Valid URL: https://records.nhl.com/site/api/coach-career-records-regular-plus-playoffs

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idintegerUnique player identifier.
active_coachlogicalIndicates whether the coach is currently active as an NHL head coach.
coach_idintegerESPN coach id parsed from the $ref URL.
coach_namecharacterFull display name of the NHL head coach.
end_seasonintegerThe most recent season the coach held a head-coaching position, encoded as an eight-digit season ID.
gamesintegerGames played.
lossesintegerLosses.
ot_lossesdoubleOvertime losses.
seasonsintegerNumber of NHL seasons the coach has served as a head coach, including playoff appearances.
start_seasonintegerThe first season the coach served as an NHL head coach, encoded as an eight-digit season ID.
team_abbrevscharacterTeam abbreviation(s).
tiesdoubleTotal ties.
winsintegerWins.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nhl_records_coach_career_with_playoffs()

Last validated n/a.

nhl_records_coach_franchise​

Coach records scoped to individual franchise stints.

Endpoint URL: GET https://records.nhl.com/site/api/coach-franchise-records/{coach_id}

Valid URL: https://records.nhl.com/site/api/coach-franchise-records

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_id path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idintegerUnique player identifier.
active_coachlogicalIndicates whether the coach is currently active with the franchise.
coach_namecharacterFull display name of the coach as recorded in NHL records.
end_seasonintegerLast season (in YYYYYYYY format) the coach was behind the bench for this franchise.
first_coached_datecharacterCalendar date on which the coach first handled a game for this franchise.
first_namecharacterPlayer first name.
franchise_idintegerUnique franchise identifier.
franchise_namecharacterFranchise name.
game_type_idintegerGame type identifier (regular/playoffs).
gamesintegerGames played.
home_gamesinteger
home_lossesintegerLosses at home.
home_ot_lossesdoubleHome overtime losses.
home_tiesdoubleTies at home.
home_win_pctgdoubleFraction of home games the coach's franchise won during their tenure.
home_winsintegerWins at home.
jack_adamsintegerNumber of Jack Adams Awards (NHL coach of the year) won by the coach during this franchise tenure.
last_coached_datecharacterCalendar date of the coach's most recent game on the bench for this franchise.
last_namecharacterPlayer last name.
lossesintegerLosses.
losses_in_otintegerNumber of games the coach's franchise lost in overtime during the tenure.
losses_in_ot_plus_shootoutintegerCombined losses in overtime and shootout during the coach's franchise tenure.
losses_in_shootoutdoubleNumber of games the coach's franchise lost in a shootout during the tenure.
ot_lossesdoubleOvertime losses.
point_pctgdoublePoints percentage.
pointsintegerTotal points (goals + assists).
road_gamesintegerTotal regular-season road games coached with this franchise.
road_lossesintegerLosses on the road.
road_ot_lossesdoubleRoad overtime losses.
road_tiesdoubleTies on the road.
road_win_pctgdoubleFraction of away games the coach's franchise won during their tenure.
road_winsintegerWins on the road.
seasonsintegerNumber of NHL seasons the coach spent with this franchise.
stanley_cup_final_appearancesintegerNumber of Stanley Cup Final appearances made while coaching this franchise.
stanley_cupsintegerNumber of Stanley Cup championships won while coaching this franchise.
start_seasonintegerFirst season (in YYYYYYYY format) the coach served with this franchise.
team_abbrevcharacterTeam abbreviation.
team_namecharacterTeam name.
tiesdoubleTotal ties.
ties_in_otintegerNumber of overtime ties recorded under this coach for this franchise (pre-shootout era).
win_pctgdoubleOverall win percentage across all regular-season games coached with this franchise.
winsintegerWins.
wins_in_otintegerNumber of games the coach's franchise won in overtime during the tenure.
wins_in_ot_plus_shootoutintegerCombined wins in overtime and shootout during the coach's franchise tenure.
wins_in_shootoutdoubleWins in shootout.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nhl_records_coach_franchise()

Last validated n/a.

nhl_records_coach_stanley_cup​

Coach Stanley Cup Final win streak and consecutive-cup records.

Endpoint URL: GET https://records.nhl.com/site/api/coach-stanley-cup-streak

Valid URL: https://records.nhl.com/site/api/coach-stanley-cup-streak

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idintegerUnique player identifier.
active_coachlogicalBoolean flag indicating whether the coach is currently active as an NHL head coach.
coach_idintegerESPN coach id parsed from the $ref URL.
coach_namecharacterFull name of the head coach in this Stanley Cup championship record.
franchise_iddoubleUnique franchise identifier.
franchise_namecharacterFranchise name.
longest_streakintegerMaximum number of consecutive seasons in which the coach won the Stanley Cup.
longest_streak_descriptioncharacterHuman-readable description of the coach's longest consecutive Stanley Cup winning streak.
seasons_woncharacterComma-separated list of NHL seasons in which the coach won the Stanley Cup as head coach.
stanley_cupsintegerTotal number of Stanley Cup championships won by this coach as head coach.
team_abbrevscharacterTeam abbreviation(s).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nhl_records_coach_stanley_cup()

Last validated n/a.