NHL — NHL Stats REST API

sportsdataverse.nhl — 21 endpoints.

nhl_stats_rest_ping

Ping the NHL Stats REST API database.

Endpoint URL: GET https://api.nhle.com/stats/rest/ping

Valid URL: https://api.nhle.com/stats/rest/ping

API Parameter	Python	Pattern	Required	Nullable

Returns

Ping the NHL Stats REST API database.

Example

nhl_stats_rest_ping()

Last validated n/a.

nhl_stats_rest_component_season

Retrieve the component-season configuration.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/componentSeason

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

Retrieve the component-season configuration.

Example

nhl_stats_rest_component_season()

Last validated n/a.

nhl_stats_rest_config

Retrieve the Stats REST API configuration payload.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/config

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

Retrieve the Stats REST API configuration payload.

Example

nhl_stats_rest_config()

Last validated n/a.

nhl_stats_rest_content_module

Retrieve a content module by template key.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/content/module/{template_key}

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
template_key	template_key		Y
lang	lang			Y

Returns

Retrieve a content module by template key.

Example

nhl_stats_rest_content_module(template_key='X')

Last validated n/a.

nhl_stats_rest_country

Retrieve the list of countries used in NHL data.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/country

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

col_name	type	description
id	character
country3_code	character
country_code	character
country_name	character
has_player_stats	integer
image_url	character
ioc_code	character
is_active	integer
nationality_name	character
olympic_url	character
thumbnail_url	character

Example

nhl_stats_rest_country()

Last validated n/a.

nhl_stats_rest_draft

Retrieve draft data, optionally filtered with Cayenne expressions.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/draft

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

Retrieve draft data, optionally filtered with Cayenne expressions.

Example

nhl_stats_rest_draft()

Last validated n/a.

nhl_stats_rest_franchise

Retrieve franchise data.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/franchise

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

col_name	type	description
id	integer
full_name	character
team_common_name	character
team_place_name	character

Example

nhl_stats_rest_franchise()

Last validated n/a.

nhl_stats_rest_game

Retrieve game-level data.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/game

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

Retrieve game-level data.

Example

nhl_stats_rest_game()

Last validated n/a.

nhl_stats_rest_glossary

Retrieve the NHL Stats glossary of stat definitions.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/glossary

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

col_name	type	description
id	integer
abbreviation	character
definition	character
first_season_for_stat	double
full_name	character
language_code	character
last_updated	character

Example

nhl_stats_rest_glossary()

Last validated n/a.

nhl_stats_rest_goalie_report

Retrieve a goalie statistical report.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/goalie/{report}

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
report	report		Y
lang	lang			Y

Returns

col_name	type	description
assists	integer
games_played	integer
games_started	integer
goalie_full_name	character
goals	integer
goals_against	integer
goals_against_average	double
last_name	character
losses	integer
ot_losses	integer
penalty_minutes	integer
player_id	integer
points	integer
save_pct	double
saves	integer
season_id	integer
shoots_catches	character
shots_against	integer
shutouts	integer
team_abbrevs	character
ties	character
time_on_ice	integer
wins	integer

Example

nhl_stats_rest_goalie_report(report='summary')

Last validated n/a.

nhl_stats_rest_leaders_goalies

Retrieve league leaders for a goalie statistical attribute.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/leaders/goalies/{attribute}

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
attribute	attribute		Y
lang	lang			Y

Returns

Retrieve league leaders for a goalie statistical attribute.

Example

nhl_stats_rest_leaders_goalies(attribute='X')

Last validated n/a.

nhl_stats_rest_leaders_skaters

Retrieve league leaders for a skater statistical attribute.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/leaders/skaters/{attribute}

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
attribute	attribute		Y
lang	lang			Y

Returns

Retrieve league leaders for a skater statistical attribute.

Example

nhl_stats_rest_leaders_skaters(attribute='X')

Last validated n/a.

nhl_stats_rest_milestones_goalies

Retrieve milestone data for goalies.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/milestones/goalies

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

Retrieve milestone data for goalies.

Example

nhl_stats_rest_milestones_goalies()

Last validated n/a.

nhl_stats_rest_milestones_skaters

Retrieve milestone data for skaters.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/milestones/skaters

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

Retrieve milestone data for skaters.

Example

nhl_stats_rest_milestones_skaters()

Last validated n/a.

nhl_stats_rest_players

Retrieve the NHL player registry.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/players

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

Retrieve the NHL player registry.

Example

nhl_stats_rest_players()

Last validated n/a.

nhl_stats_rest_season

Retrieve the list of all NHL seasons.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/season

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

col_name	type	description
id	integer
all_star_game_in_use	integer
conferences_in_use	integer
divisions_in_use	integer
end_date	character
entry_draft_in_use	integer
formatted_season_id	character
minimum_playoff_minutes_for_goalie_stats_leaders	integer
minimum_regular_games_for_goalie_stats_leaders	integer
nhl_stanley_cup_owner	integer
number_of_games	integer
olympics_participation	integer
point_for_ot_loss_in_use	integer
preseason_startdate	character
regular_season_end_date	character
row_in_use	integer
season_ordinal	integer
start_date	character
supplemental_draft_in_use	integer
ties_in_use	integer
total_playoff_games	integer
total_regular_season_games	integer
wildcard_in_use	integer

Example

nhl_stats_rest_season()

Last validated n/a.

nhl_stats_rest_shiftcharts

Retrieve shift-chart data.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/shiftcharts

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

Retrieve shift-chart data.

Example

nhl_stats_rest_shiftcharts()

Last validated n/a.

nhl_stats_rest_skater_report

Retrieve a skater statistical report.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/skater/{report}

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
report	report		Y
lang	lang			Y

Returns

col_name	type	description
assists	integer
ev_goals	integer
ev_points	integer
faceoff_win_pct	double
game_winning_goals	integer
games_played	integer
goals	integer
last_name	character
ot_goals	integer
penalty_minutes	integer
player_id	integer
plus_minus	integer
points	integer
points_per_game	double
position_code	character
pp_goals	integer
pp_points	integer
season_id	integer
sh_goals	integer
sh_points	integer
shooting_pct	double
shoots_catches	character
shots	integer
skater_full_name	character
team_abbrevs	character
time_on_ice_per_game	double

Example

nhl_stats_rest_skater_report(report='summary')

Last validated n/a.

nhl_stats_rest_team

Retrieve the list of all NHL teams.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/team

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
lang	lang			Y

Returns

Retrieve the list of all NHL teams.

Example

nhl_stats_rest_team()

Last validated n/a.

nhl_stats_rest_team_by_id

Retrieve a single team by its numeric ID.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/team/id/{team_id}

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
team_id	team_id		Y
lang	lang			Y

Returns

Retrieve a single team by its numeric ID.

Example

nhl_stats_rest_team_by_id(team_id=10)

Last validated n/a.

nhl_stats_rest_team_report

Retrieve a team statistical report.

Endpoint URL: GET https://api.nhle.com/stats/rest/{lang}/team/{report}

Valid URL: https://api.nhle.com/stats/rest

API Parameter	Python	Pattern	Required	Nullable
report	report		Y
lang	lang			Y

Returns

col_name	type	description
faceoff_win_pct	double
games_played	integer
goals_against	integer
goals_against_per_game	double
goals_for	integer
goals_for_per_game	double
losses	integer
ot_losses	integer
penalty_kill_net_pct	double
penalty_kill_pct	double
point_pct	double
points	integer
power_play_net_pct	double
power_play_pct	double
regulation_and_ot_wins	integer
season_id	integer
shots_against_per_game	double
shots_for_per_game	double
team_full_name	character
team_id	integer
team_shutouts	integer
ties	character
wins	integer
wins_in_regulation	integer
wins_in_shootout	integer

Example

nhl_stats_rest_team_report(report='summary')

Last validated n/a.