NHL — NHL Records API
sportsdataverse.nhl — 44 endpoints.
nhl_records_awards
List all NHL award / trophy records.
Endpoint URL: GET https://records.nhl.com/site/api/award-details
Valid URL: https://records.nhl.com/site/api/award-details
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
List all NHL award / trophy records.
Example
nhl_records_awards()
Last validated n/a.
nhl_records_awards_by_franchise
List award records for a single franchise.
Endpoint URL: GET https://records.nhl.com/site/api/award-details/{franchise_id}
Valid URL: https://records.nhl.com/site/api/award-details/1
| API Parameter | Python | Pattern | Required | Nullable |
|---|---|---|---|---|
franchise_id | franchise_id | Y |
Returns
List award records for a single franchise.
Example
nhl_records_awards_by_franchise(franchise_id=1)
Last validated n/a.
nhl_records_awards_trophy_season
Retrieve the trophy winner for a specific season.
Endpoint URL: GET https://records.nhl.com/site/api/award-details/trophy/{trophy_id}/season/{season_id}
Valid URL: https://records.nhl.com/site/api/award-details/trophy/1/season/X
| API Parameter | Python | Pattern | Required | Nullable |
|---|---|---|---|---|
trophy_id | trophy_id | Y | ||
season_id | season_id | Y |
Returns
Retrieve the trophy winner for a specific season.
Example
nhl_records_awards_trophy_season(trophy_id=1, season_id='X')
Last validated n/a.
nhl_records_coaches
List NHL head coaches.
Endpoint URL: GET https://records.nhl.com/site/api/coach
Valid URL: https://records.nhl.com/site/api/coach
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
List NHL head coaches.
Example
nhl_records_coaches()
Last validated n/a.
nhl_records_coach
Retrieve one coach by their numeric ID.
Endpoint URL: GET https://records.nhl.com/site/api/coach/{coach_id}
Valid URL: https://records.nhl.com/site/api/coach/X
| API Parameter | Python | Pattern | Required | Nullable |
|---|---|---|---|---|
coach_id | coach_id | Y |
Returns
Retrieve one coach by their numeric ID.
Example
nhl_records_coach(coach_id='X')
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable |
|---|---|---|---|---|
coach_id | coach_id | Y |
Returns
Coach career-records (regular season).
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 Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Coach career records inclusive of regular season + playoffs.
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 Parameter | Python | Pattern | Required | Nullable |
|---|---|---|---|---|
coach_id | coach_id | Y |
Returns
Coach records scoped to individual franchise stints.
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 Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Coach Stanley Cup Final win streak and consecutive-cup records.
Example
nhl_records_coach_stanley_cup()
Last validated n/a.
nhl_records_franchises
List all NHL franchises (historical and active).
Endpoint URL: GET https://records.nhl.com/site/api/franchise
Valid URL: https://records.nhl.com/site/api/franchise
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
List all NHL franchises (historical and active).
Example
nhl_records_franchises()
Last validated n/a.
nhl_records_franchise_detail
Franchise detail records (extended metadata per franchise).
Endpoint URL: GET https://records.nhl.com/site/api/franchise-detail
Valid URL: https://records.nhl.com/site/api/franchise-detail
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Franchise detail records (extended metadata per franchise).
Example
nhl_records_franchise_detail()
Last validated n/a.
nhl_records_franchise_team_totals
All-time team totals per franchise (regular season).
Endpoint URL: GET https://records.nhl.com/site/api/franchise-team-totals
Valid URL: https://records.nhl.com/site/api/franchise-team-totals
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
All-time team totals per franchise (regular season).
Example
nhl_records_franchise_team_totals()
Last validated n/a.
nhl_records_franchise_season_results
Season-by-season results for each franchise.
Endpoint URL: GET https://records.nhl.com/site/api/franchise-season-results
Valid URL: https://records.nhl.com/site/api/franchise-season-results
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Season-by-season results for each franchise.
Example
nhl_records_franchise_season_results()
Last validated n/a.
nhl_records_franchise_playoff_appearances
Franchise playoff appearance counts and streak information.
Endpoint URL: GET https://records.nhl.com/site/api/franchise-playoff-appearances
Valid URL: https://records.nhl.com/site/api/franchise-playoff-appearances
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Franchise playoff appearance counts and streak information.
Example
nhl_records_franchise_playoff_appearances()
Last validated n/a.
nhl_records_franchise_totals
League-wide franchise totals (all-time aggregate per franchise).
Endpoint URL: GET https://records.nhl.com/site/api/franchise-totals
Valid URL: https://records.nhl.com/site/api/franchise-totals
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
League-wide franchise totals (all-time aggregate per franchise).
Example
nhl_records_franchise_totals()
Last validated n/a.
nhl_records_all_time_record_vs_franchise
All-time head-to-head records between every franchise pairing.
Endpoint URL: GET https://records.nhl.com/site/api/all-time-record-vs-franchise
Valid URL: https://records.nhl.com/site/api/all-time-record-vs-franchise
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
All-time head-to-head records between every franchise pairing.
Example
nhl_records_all_time_record_vs_franchise()
Last validated n/a.
nhl_records_skater_career_stats
Skater career statistics (all-time, regular season).
Endpoint URL: GET https://records.nhl.com/site/api/skater-career-statistics
Valid URL: https://records.nhl.com/site/api/skater-career-statistics
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Skater career statistics (all-time, regular season).
Example
nhl_records_skater_career_stats()
Last validated n/a.
nhl_records_skater_career_leaders
All-time skater career leaderboards.
Endpoint URL: GET https://records.nhl.com/site/api/skater-career-leaders
Valid URL: https://records.nhl.com/site/api/skater-career-leaders
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
All-time skater career leaderboards.
Example
nhl_records_skater_career_leaders()
Last validated n/a.
nhl_records_consecutive_100pt_seasons
Skaters with the most consecutive 100-point seasons.
Endpoint URL: GET https://records.nhl.com/site/api/consecutive-100-point-seasons
Valid URL: https://records.nhl.com/site/api/consecutive-100-point-seasons
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Skaters with the most consecutive 100-point seasons.
Example
nhl_records_consecutive_100pt_seasons()
Last validated n/a.
nhl_records_goalie_career_stats
Goaltender career statistics (regular season).
Endpoint URL: GET https://records.nhl.com/site/api/goalie-career-stats
Valid URL: https://records.nhl.com/site/api/goalie-career-stats
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Goaltender career statistics (regular season).
Example
nhl_records_goalie_career_stats()
Last validated n/a.
nhl_records_goalie_career_stats_with_playoffs
Goaltender career stats inclusive of regular season and playoffs.
Endpoint URL: GET https://records.nhl.com/site/api/goalie_career_stats_incl_playoffs
Valid URL: https://records.nhl.com/site/api/goalie_career_stats_incl_playoffs
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Goaltender career stats inclusive of regular season and playoffs.
Example
nhl_records_goalie_career_stats_with_playoffs()
Last validated n/a.
nhl_records_goalie_season_stats
Goaltender single-season statistics.
Endpoint URL: GET https://records.nhl.com/site/api/goalie-season-stats
Valid URL: https://records.nhl.com/site/api/goalie-season-stats
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Goaltender single-season statistics.
Example
nhl_records_goalie_season_stats()
Last validated n/a.
nhl_records_goalie_win_streak
Goaltenders with the longest consecutive-win streaks.
Endpoint URL: GET https://records.nhl.com/site/api/goalie-win-streak
Valid URL: https://records.nhl.com/site/api/goalie-win-streak
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Goaltenders with the longest consecutive-win streaks.
Example
nhl_records_goalie_win_streak()
Last validated n/a.
nhl_records_goalie_shutout_streak
Goaltenders with the longest consecutive-shutout streaks.
Endpoint URL: GET https://records.nhl.com/site/api/goalie-shutout-streak
Valid URL: https://records.nhl.com/site/api/goalie-shutout-streak
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Goaltenders with the longest consecutive-shutout streaks.
Example
nhl_records_goalie_shutout_streak()
Last validated n/a.
nhl_records_goalie_win_plateaus
Goaltenders who reached each win plateau (100, 200, 300 …).
Endpoint URL: GET https://records.nhl.com/site/api/goalie-win-plateaus
Valid URL: https://records.nhl.com/site/api/goalie-win-plateaus
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Goaltenders who reached each win plateau (100, 200, 300 …).
Example
nhl_records_goalie_win_plateaus()
Last validated n/a.
nhl_records_goalie_playoff_streak
Goaltender consecutive playoff-win streaks.
Endpoint URL: GET https://records.nhl.com/site/api/goalie-playoff-streak
Valid URL: https://records.nhl.com/site/api/goalie-playoff-streak
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Goaltender consecutive playoff-win streaks.
Example
nhl_records_goalie_playoff_streak()
Last validated n/a.
nhl_records_goalie_undefeated_streak
Goaltender longest undefeated streaks (wins + ties).
Endpoint URL: GET https://records.nhl.com/site/api/goalie-undefeated-streak
Valid URL: https://records.nhl.com/site/api/goalie-undefeated-streak
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Goaltender longest undefeated streaks (wins + ties).
Example
nhl_records_goalie_undefeated_streak()
Last validated n/a.
nhl_records_draft
Retrieve NHL Entry Draft picks.
Endpoint URL: GET https://records.nhl.com/site/api/draft/{draft_id}
Valid URL: https://records.nhl.com/site/api/draft
| API Parameter | Python | Pattern | Required | Nullable |
|---|---|---|---|---|
draft_id | draft_id | Y |
Returns
Retrieve NHL Entry Draft picks.
Example
nhl_records_draft()
Last validated n/a.
nhl_records_draft_by_team
All draft picks made by a single team.
Endpoint URL: GET https://records.nhl.com/site/api/draft/byTeam/{team_id}
Valid URL: https://records.nhl.com/site/api/draft/byTeam/10
| API Parameter | Python | Pattern | Required | Nullable |
|---|---|---|---|---|
team_id | team_id | Y |
Returns
All draft picks made by a single team.
Example
nhl_records_draft_by_team(team_id=10)
Last validated n/a.
nhl_records_draft_prospect
Draft prospect records.
Endpoint URL: GET https://records.nhl.com/site/api/draft-prospect/{prospect_id}
Valid URL: https://records.nhl.com/site/api/draft-prospect
| API Parameter | Python | Pattern | Required | Nullable |
|---|---|---|---|---|
prospect_id | prospect_id | Y |
Returns
Draft prospect records.
Example
nhl_records_draft_prospect()
Last validated n/a.
nhl_records_draft_lottery_odds
Draft lottery odds (current year or filtered by season).
Endpoint URL: GET https://records.nhl.com/site/api/draft-lottery-odds
Valid URL: https://records.nhl.com/site/api/draft-lottery-odds
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Draft lottery odds (current year or filtered by season).
Example
nhl_records_draft_lottery_odds()
Last validated n/a.
nhl_records_expansion_draft_picks
Expansion draft picks (e.g. Vegas 2017, Seattle 2021).
Endpoint URL: GET https://records.nhl.com/site/api/expansion-draft-picks
Valid URL: https://records.nhl.com/site/api/expansion-draft-picks
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Expansion draft picks (e.g. Vegas 2017, Seattle 2021).
Example
nhl_records_expansion_draft_picks()
Last validated n/a.
nhl_records_allstar_skater_career
All-Star Game career statistics for skaters.
Endpoint URL: GET https://records.nhl.com/site/api/all-star-skater-career-stats
Valid URL: https://records.nhl.com/site/api/all-star-skater-career-stats
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
All-Star Game career statistics for skaters.
Example
nhl_records_allstar_skater_career()
Last validated n/a.
nhl_records_allstar_goalie_career
All-Star Game career statistics for goaltenders.
Endpoint URL: GET https://records.nhl.com/site/api/all-star-goaltender-career-stats
Valid URL: https://records.nhl.com/site/api/all-star-goaltender-career-stats
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
All-Star Game career statistics for goaltenders.
Example
nhl_records_allstar_goalie_career()
Last validated n/a.
nhl_records_allstar_coach_career
All-Star Game career records for coaches.
Endpoint URL: GET https://records.nhl.com/site/api/all-star-coach-career-stats
Valid URL: https://records.nhl.com/site/api/all-star-coach-career-stats
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
All-Star Game career records for coaches.
Example
nhl_records_allstar_coach_career()
Last validated n/a.
nhl_records_allstar_skater_game
All-Star Game single-game scoring records for skaters.
Endpoint URL: GET https://records.nhl.com/site/api/all-star-skater-game-stats
Valid URL: https://records.nhl.com/site/api/all-star-skater-game-stats
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
All-Star Game single-game scoring records for skaters.
Example
nhl_records_allstar_skater_game()
Last validated n/a.
nhl_records_allstar_goalie_game
All-Star Game single-game stats for goaltenders.
Endpoint URL: GET https://records.nhl.com/site/api/all-star-goaltender-game-stats
Valid URL: https://records.nhl.com/site/api/all-star-goaltender-game-stats
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
All-Star Game single-game stats for goaltenders.
Example
nhl_records_allstar_goalie_game()
Last validated n/a.
nhl_records_attendance
NHL arena attendance records.
Endpoint URL: GET https://records.nhl.com/site/api/attendance
Valid URL: https://records.nhl.com/site/api/attendance
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
NHL arena attendance records.
Example
nhl_records_attendance()
Last validated n/a.
nhl_records_hof_players
Hockey Hall of Fame player inductees.
Endpoint URL: GET https://records.nhl.com/site/api/hof/players
Valid URL: https://records.nhl.com/site/api/hof/players
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
Hockey Hall of Fame player inductees.
Example
nhl_records_hof_players()
Last validated n/a.
nhl_records_hof_players_by_office
Hall of Fame players for a specific induction office/category.
Endpoint URL: GET https://records.nhl.com/site/api/hof/players/{office_id}
Valid URL: https://records.nhl.com/site/api/hof/players/X
| API Parameter | Python | Pattern | Required | Nullable |
|---|---|---|---|---|
office_id | office_id | Y |
Returns
Hall of Fame players for a specific induction office/category.
Example
nhl_records_hof_players_by_office(office_id='X')
Last validated n/a.
nhl_records_gm_career
General Manager career records.
Endpoint URL: GET https://records.nhl.com/site/api/general-manager/{gm_id}
Valid URL: https://records.nhl.com/site/api/general-manager
| API Parameter | Python | Pattern | Required | Nullable |
|---|---|---|---|---|
gm_id | gm_id | Y |
Returns
General Manager career records.
Example
nhl_records_gm_career()
Last validated n/a.
nhl_records_gm_franchise
General Manager records scoped to franchise stints.
Endpoint URL: GET https://records.nhl.com/site/api/general-manager-franchise-records
Valid URL: https://records.nhl.com/site/api/general-manager-franchise-records
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
General Manager records scoped to franchise stints.
Example
nhl_records_gm_franchise()
Last validated n/a.
nhl_records_home_team_record
League-wide home-team win/loss record by season.
Endpoint URL: GET https://records.nhl.com/site/api/home-team-record
Valid URL: https://records.nhl.com/site/api/home-team-record
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
League-wide home-team win/loss record by season.
Example
nhl_records_home_team_record()
Last validated n/a.
nhl_records_away_team_record
League-wide away-team win/loss record by season.
Endpoint URL: GET https://records.nhl.com/site/api/away-team-record
Valid URL: https://records.nhl.com/site/api/away-team-record
| API Parameter | Python | Pattern | Required | Nullable |
|---|
Returns
League-wide away-team win/loss record by season.
Example
nhl_records_away_team_record()
Last validated n/a.