NHL — ESPN core API (v2) — Game

espn_nhl_game_competition

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid 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_name	type	description
$ref	character
attendance	integer	Game attendance.
boxscore_available	logical	Whether boxscore data is available.
bracket_available	logical
commentary_available	logical
competitors	character
conference_competition	logical	Whether it is a conference competition.
conversation_available	logical
date	character	Game date (ISO 8601 datetime string).
division_competition	logical
gamecast_available	logical
guid	character	Athlete global unique identifier.
highlights_available	logical
id	character	Unique player identifier.
lineup_available	logical
links	character
live_available	logical
necessary	logical
neutral_site	logical	Whether the game is at a neutral site.
notes	character	Notes flag for the pick.
on_watch_espn	logical	Whether the game is/was on WatchESPN.
pickcenter_available	logical
play_by_play_available	logical	Whether play-by-play data is available.
possession_arrow_available	logical
preview_available	logical
recap_available	logical
recent	logical	Whether the game is recent.
series	character	Nested list of series within the round.
shot_chart_available	logical
summary_available	logical
tickets_available	logical
time_valid	logical	Whether the start time is confirmed.
timeouts_available	logical
uid	character	Competitor uid string.
wallclock_available	logical
boxscore_source_description	character
boxscore_source_id	character
boxscore_source_state	character
broadcasts_$ref	character
details_$ref	character
format_overtime_clock	double
format_overtime_display_name	character
format_overtime_slug	character
format_regulation_clock	double
format_regulation_display_name	character
format_regulation_periods	integer
format_regulation_slug	character
game_source_description	character
game_source_id	character
game_source_state	character
linescore_source_description	character
linescore_source_id	character
linescore_source_state	character
odds_$ref	character
officials_$ref	character
play_by_play_source_description	character
play_by_play_source_id	character
play_by_play_source_state	character
power_indexes_$ref	character
predictor_$ref	character
probabilities_$ref	character
relevancy_$ref	character
situation_$ref	character
stats_source_description	character
stats_source_id	character
stats_source_state	character
status_$ref	character
type_abbreviation	character	Play type abbreviation.
type_id	character	Play type id.
type_slug	character	Broadcast type slug.
type_text	character	Play type label (e.g. "Goal", "Shot", "Face Off").
type_type	character
venue_$ref	character
venue_address_city	character
venue_address_state	character
venue_full_name	character	Venue full name.
venue_grass	logical
venue_guid	character
venue_id	character	Venue identifier.
venue_images	character
venue_indoor	logical	Whether the venue is indoors.

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

Example

espn_nhl_game_competition(event_id='401584793')

Last validated n/a.

espn_nhl_game_teams

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/competitors

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/competitors

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid 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_name	type	description
$ref	character
home_away	character	Home or away indicator.
id	character	Unique player identifier.
order	integer	Display order within officials list.
type	character	Competitor type (e.g. "team").
uid	character	Competitor uid string.
winner	logical	Whether this competitor won the game.
leaders_$ref	character
linescores_$ref	character
record_$ref	character
roster_$ref	character
score_$ref	character
statistics_$ref	character
team_$ref	character

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

Example

espn_nhl_game_teams(event_id='401584793')

Last validated n/a.

espn_nhl_game_team

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/competitors/{team_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/competitors/4

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid 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_name	type	description
$ref	character
home_away	character	Home or away indicator.
id	character	Unique player identifier.
order	integer	Display order within officials list.
type	character	Competitor type (e.g. "team").
uid	character	Competitor uid string.
winner	logical	Whether this competitor won the game.
leaders_$ref	character
linescores_$ref	character
record_$ref	character
roster_$ref	character
score_$ref	character
statistics_$ref	character
team_$ref	character

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

Example

espn_nhl_game_team(event_id='401584793', team_id='4')

Last validated n/a.

espn_nhl_game_team_roster

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/competitors/{team_id}/roster

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/competitors/4/roster

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid 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_name	type	description
$ref	character
active	logical	Whether athlete is currently active.
starter	logical	Whether the goalie started the game.
did_not_play	logical
ejected	logical

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

Example

espn_nhl_game_team_roster(event_id='401584793', team_id='4')

Last validated n/a.

espn_nhl_game_team_linescores

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/competitors/{team_id}/linescores

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/competitors/4/linescores

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_event_competitor_linescores; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: the page holds zero items (count 0) in nba with the documented example arguments (2026-10-07).

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

Example

espn_nhl_game_team_linescores(event_id='401584793', team_id='4')

Last validated n/a.

espn_nhl_game_team_statistics

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/competitors/{team_id}/statistics

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/competitors/4/statistics

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_event_competitor_statistics; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: parser: parse_event_competitor_statistics raises AttributeError: 'str' object has no attribute 'get' on the live payload (nba, 2026-10-07), so no columns can be derived.

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

Example

espn_nhl_game_team_statistics(event_id='401584793', team_id='4')

Last validated n/a.

espn_nhl_game_team_record

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/competitors/{team_id}/record

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/competitors/4/record

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_single_entity; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

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

Example

espn_nhl_game_team_record(event_id='401584793', team_id='4')

Last validated n/a.

espn_nhl_game_team_leaders

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/competitors/{team_id}/leaders

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/competitors/4/leaders

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: parser: parse_items returns no columns on the live payload (nba, 2026-10-07); its rows sit under keys it does not read (top level: $ref, abbreviation, categories, id, name, type).

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

Example

espn_nhl_game_team_leaders(event_id='401584793', team_id='4')

Last validated n/a.

espn_nhl_game_odds

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/odds

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/odds

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid 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_name	type	description
$ref	character
details	character	Odds detail string (e.g. "DET -185").
moneyline_winner	logical	Whether the moneyline winner was determined.
over_odds	double	Over moneyline odds (American format).
over_under	double	Over/under total line.
spread	double	Point spread.
spread_winner	logical	Whether the spread winner was determined.
under_odds	double	Under moneyline odds (American format).
away_team_odds_close_money_line_alternate_display_value	character
away_team_odds_close_money_line_american	character
away_team_odds_close_money_line_decimal	double
away_team_odds_close_money_line_display_value	character
away_team_odds_close_money_line_fraction	character
away_team_odds_close_money_line_value	double
away_team_odds_close_point_spread_alternate_display_value	character
away_team_odds_close_point_spread_american	character
away_team_odds_close_spread_alternate_display_value	character
away_team_odds_close_spread_american	character
away_team_odds_close_spread_decimal	double
away_team_odds_close_spread_display_value	character
away_team_odds_close_spread_fraction	character
away_team_odds_close_spread_value	double
away_team_odds_current_money_line_alternate_display_value	character
away_team_odds_current_money_line_american	character
away_team_odds_current_money_line_decimal	double
away_team_odds_current_money_line_display_value	character
away_team_odds_current_money_line_fraction	character
away_team_odds_current_money_line_value	double
away_team_odds_current_point_spread_alternate_display_value	character
away_team_odds_current_point_spread_american	character
away_team_odds_current_spread_alternate_display_value	character
away_team_odds_current_spread_american	character
away_team_odds_current_spread_decimal	double
away_team_odds_current_spread_display_value	character
away_team_odds_current_spread_fraction	character
away_team_odds_current_spread_value	double
away_team_odds_favorite	logical
away_team_odds_money_line	integer
away_team_odds_open_favorite	logical
away_team_odds_open_money_line_alternate_display_value	character
away_team_odds_open_money_line_american	character
away_team_odds_open_money_line_decimal	double
away_team_odds_open_money_line_display_value	character
away_team_odds_open_money_line_fraction	character
away_team_odds_open_money_line_value	double
away_team_odds_open_point_spread_alternate_display_value	character
away_team_odds_open_point_spread_american	character
away_team_odds_open_spread_alternate_display_value	character
away_team_odds_open_spread_american	character
away_team_odds_open_spread_decimal	double
away_team_odds_open_spread_display_value	character
away_team_odds_open_spread_fraction	character
away_team_odds_open_spread_value	double
away_team_odds_spread_odds	double
away_team_odds_team_$ref	character
away_team_odds_underdog	logical
close_over_alternate_display_value	character
close_over_american	character
close_over_decimal	double
close_over_display_value	character
close_over_fraction	character
close_over_value	double
close_total_alternate_display_value	character
close_total_american	character
close_total_decimal	double
close_total_display_value	character
close_total_fraction	character
close_total_value	double
close_under_alternate_display_value	character
close_under_american	character
close_under_decimal	double
close_under_display_value	character
close_under_fraction	character
close_under_value	double
current_over_alternate_display_value	character
current_over_american	character
current_over_decimal	double
current_over_display_value	character
current_over_fraction	character
current_over_value	double
current_total_alternate_display_value	character
current_total_american	character
current_total_decimal	double
current_total_display_value	character
current_total_fraction	character
current_total_value	double
current_under_alternate_display_value	character
current_under_american	character
current_under_decimal	double
current_under_display_value	character
current_under_fraction	character
current_under_value	double
home_team_odds_close_money_line_alternate_display_value	character
home_team_odds_close_money_line_american	character
home_team_odds_close_money_line_decimal	double
home_team_odds_close_money_line_display_value	character
home_team_odds_close_money_line_fraction	character
home_team_odds_close_money_line_value	double
home_team_odds_close_point_spread_alternate_display_value	character
home_team_odds_close_point_spread_american	character
home_team_odds_close_point_spread_decimal	double
home_team_odds_close_point_spread_display_value	character
home_team_odds_close_point_spread_fraction	character
home_team_odds_close_point_spread_value	double
home_team_odds_close_spread_alternate_display_value	character
home_team_odds_close_spread_american	character
home_team_odds_close_spread_decimal	double
home_team_odds_close_spread_display_value	character
home_team_odds_close_spread_fraction	character
home_team_odds_close_spread_value	double
home_team_odds_current_money_line_alternate_display_value	character
home_team_odds_current_money_line_american	character
home_team_odds_current_money_line_decimal	double
home_team_odds_current_money_line_display_value	character
home_team_odds_current_money_line_fraction	character
home_team_odds_current_money_line_value	double
home_team_odds_current_point_spread_alternate_display_value	character
home_team_odds_current_point_spread_american	character
home_team_odds_current_point_spread_decimal	double
home_team_odds_current_point_spread_display_value	character
home_team_odds_current_point_spread_fraction	character
home_team_odds_current_point_spread_value	double
home_team_odds_current_spread_alternate_display_value	character
home_team_odds_current_spread_american	character
home_team_odds_current_spread_decimal	double
home_team_odds_current_spread_display_value	character
home_team_odds_current_spread_fraction	character
home_team_odds_current_spread_value	double
home_team_odds_favorite	logical
home_team_odds_money_line	integer
home_team_odds_open_favorite	logical
home_team_odds_open_money_line_alternate_display_value	character
home_team_odds_open_money_line_american	character
home_team_odds_open_money_line_decimal	double
home_team_odds_open_money_line_display_value	character
home_team_odds_open_money_line_fraction	character
home_team_odds_open_money_line_value	double
home_team_odds_open_point_spread_alternate_display_value	character
home_team_odds_open_point_spread_american	character
home_team_odds_open_point_spread_decimal	double
home_team_odds_open_point_spread_display_value	character
home_team_odds_open_point_spread_fraction	character
home_team_odds_open_point_spread_value	double
home_team_odds_open_spread_alternate_display_value	character
home_team_odds_open_spread_american	character
home_team_odds_open_spread_decimal	double
home_team_odds_open_spread_display_value	character
home_team_odds_open_spread_fraction	character
home_team_odds_open_spread_value	double
home_team_odds_spread_odds	double
home_team_odds_team_$ref	character
home_team_odds_underdog	logical
open_over_alternate_display_value	character
open_over_american	character
open_over_decimal	double
open_over_display_value	character
open_over_fraction	character
open_over_value	double
open_total_alternate_display_value	character
open_total_american	character	Opening total line in American format (e.g. "5.5").
open_total_decimal	double
open_total_display_value	character
open_total_fraction	character
open_total_value	double
open_under_alternate_display_value	character
open_under_american	character
open_under_decimal	double
open_under_display_value	character
open_under_fraction	character
open_under_value	double
provider_$ref	character
provider_id	character	ESPN provider id parsed from the $ref URL.
provider_name	character	Betting provider name (e.g. "ESPN BET").
provider_priority	integer	Provider display priority.
prop_bets_$ref	character

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

Example

espn_nhl_game_odds(event_id='401584793')

Last validated n/a.

espn_nhl_game_probabilities

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/probabilities

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/probabilities?limit=300

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.
limit	limit			Y	Maximum number of items to return.

Returns

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

col_name	type	description
$ref	character
away_win_percentage	double	Away team win probability (0-1).
home_win_percentage	double	Home team win probability (0-1).
last_modified	character	Last-modified datetime (ISO 8601).
sequence_number	character	Play sequence number within the game.
spread_cover_prob_home	double
spread_push_prob	double
tie_percentage	double	Tie probability (0-1; typically 0 for NHL).
total_over_prob	double
away_team_$ref	character
competition_$ref	character
home_team_$ref	character
play_$ref	character
source_description	character
source_id	character	Data source identifier.
source_state	character

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

Example

espn_nhl_game_probabilities(event_id='401584793')

Last validated n/a.

espn_nhl_game_plays

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/plays

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/plays?limit=1000

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.
limit	limit			Y	Maximum number of items to return.

Returns

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

col_name	type	description
$ref	character
alternative_text	character
away_score	integer	Away team final score.
clock_display_value	character	Game clock display string (e.g. "14:32").
clock_value	double	Clock value in seconds.
coordinate_x	integer	X coordinate on the ice surface.
coordinate_y	integer	Y coordinate on the ice surface.
home_score	integer	Home team final score.
id	character	Unique player identifier.
modified	character
period_display_value	character	Period display label (e.g. "1st Period").
period_number	integer	Period number (1-3 regulation, 4+ OT).
points_attempted	integer
priority	logical	Whether this is a priority play for display.
probability_$ref	character
score_value	integer	Point value of the scoring play (1 for a goal).
scoring_play	logical	Whether this play resulted in a goal.
sequence_number	character	Play sequence number within the game.
shooting_play	logical	Whether this is a shot on goal.
team_$ref	character
text	character	Full play description text.
type_id	character	Play type id.
type_text	character	Play type label (e.g. "Goal", "Shot", "Face Off").
valid	logical
wallclock	character	Wall-clock UTC timestamp of the play.
short_alternative_text	character
short_text	character	Short play description text.

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

Example

espn_nhl_game_plays(event_id='401584793')

Last validated n/a.

espn_nhl_game_play

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/plays/{play_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/plays/1

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
play_id	play_id		Y		play_id path parameter.
cid	cid			Y	cid 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_name	type	description
$ref	character
alternative_text	character
away_score	integer	Away team final score.
home_score	integer	Home team final score.
id	character	Unique player identifier.
modified	character
participants	character
points_attempted	integer
priority	logical	Whether this is a priority play for display.
score_value	integer	Point value of the scoring play (1 for a goal).
scoring_play	logical	Whether this play resulted in a goal.
sequence_number	character	Play sequence number within the game.
shooting_play	logical	Whether this is a shot on goal.
text	character	Full play description text.
valid	logical
wallclock	character	Wall-clock UTC timestamp of the play.
clock_display_value	character	Game clock display string (e.g. "14:32").
clock_value	double	Clock value in seconds.
coordinate_x	integer	X coordinate on the ice surface.
coordinate_y	integer	Y coordinate on the ice surface.
period_display_value	character	Period display label (e.g. "1st Period").
period_number	integer	Period number (1-3 regulation, 4+ OT).
probability_$ref	character
team_$ref	character
type_id	character	Play type id.
type_text	character	Play type label (e.g. "Goal", "Shot", "Face Off").

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

Example

espn_nhl_game_play(event_id='401584793', play_id='1')

Last validated n/a.

espn_nhl_game_play_personnel

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/plays/{play_id}/personnel

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/plays/1/personnel

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
play_id	play_id		Y		play_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: parser: parse_items returns no columns on the live payload (nba, 2026-10-07); its rows sit under keys it does not read (top level: $ref, playPersonnel).

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

Example

espn_nhl_game_play_personnel(event_id='401584793', play_id='1')

Last validated n/a.

espn_nhl_game_situation

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/situation

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/situation

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid 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_name	type	description
$ref	character
away_fouls_bonus_state	character
away_fouls_fouls_to_give	integer
away_fouls_team_fouls	integer
away_fouls_team_fouls_current	integer
away_timeouts_timeouts_current	integer
away_timeouts_timeouts_remaining_current	integer
home_fouls_bonus_state	character
home_fouls_fouls_to_give	integer
home_fouls_team_fouls	integer
home_fouls_team_fouls_current	integer
home_timeouts_timeouts_current	integer
home_timeouts_timeouts_remaining_current	integer
last_play_$ref	character

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

Example

espn_nhl_game_situation(event_id='401584793')

Last validated n/a.

espn_nhl_game_status

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/status

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/status

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid 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_name	type	description
$ref	character
clock	double	Game clock time remaining (MM:SS).
display_clock	character	Game clock display string (e.g. "0:00").
period	integer	Period number.
type_completed	logical	Whether the game is complete.
type_description	character	Status description (e.g. "Final").
type_detail	character	Status detail string.
type_id	character	Play type id.
type_name	character	Status type name (e.g. "STATUS_FINAL").
type_short_detail	character	Short status detail string.
type_state	character	Status state (e.g. "pre", "in", "post").

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

Example

espn_nhl_game_status(event_id='401584793')

Last validated n/a.

espn_nhl_game_officials

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/officials

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/officials

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid 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_name	type	description
$ref	character
display_name	character	Player display name.
first_name	character	Player first name.
full_name	character	Player full name.
id	character	Unique player identifier.
last_name	character	Player last name.
order	integer	Display order within officials list.
position_display_name	character	Position display name.
position_id	character	Official position identifier.
position_name	character	Official position name (e.g. "Referee", "Linesman").

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

Example

espn_nhl_game_officials(event_id='401584793')

Last validated n/a.

espn_nhl_game_broadcasts

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/broadcasts

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/broadcasts

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid 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_name	type	description
channel	integer	Channel number identifier.
lang	character	Broadcast language (e.g. "en").
partnered	logical	Whether this is a partnered broadcast.
priority	integer	Whether this is a priority play for display.
region	character	Broadcast region (e.g. "us").
slug	character	URL slug.
station	character	Station full name (e.g. "FanDuel Sports Network Detroit").
competition_$ref	character
market_id	character	Market identifier.
market_type	character	Market type.
media_$ref	character
media_call_letters	character	Media outlet call letters.
media_id	character	Media outlet identifier.
media_logos	character
media_name	character	Media outlet full name.
media_short_name	character	Media outlet short name.
media_slug	character	Media outlet slug.
type_id	character	Play type id.
type_long_name	character	Broadcast type long name (e.g. "Television").
type_short_name	character	Broadcast type short name (e.g. "TV").
type_slug	character	Broadcast type slug.

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

Example

espn_nhl_game_broadcasts(event_id='401584793')

Last validated n/a.

espn_nhl_game_predictor

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/predictor

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/predictor

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid 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_name	type	description
$ref	character
last_modified	character	Last-modified datetime (ISO 8601).
name	character	Team mascot name.
short_name	character	Short game name.
away_team_statistics	character
away_team_team_$ref	character
home_team_team_$ref	character

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

Example

espn_nhl_game_predictor(event_id='401584793')

Last validated n/a.

espn_nhl_game_powerindex

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/powerindex

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/powerindex

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid 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_name	type	description
count	integer	Total athlete count matching the filter.
items	character
page_count	integer	Total pages in the collection.
page_index	integer
page_size	integer

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

Example

espn_nhl_game_powerindex(event_id='401584793')

Last validated n/a.

espn_nhl_game_propbets

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/propbets

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/propbets

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

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

Example

espn_nhl_game_propbets(event_id='401584793')

Last validated n/a.

espn_nhl_game_leaders

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/leaders

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/leaders

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nfl, mlb, nhl, wnba, cfb, mbb, wbb; 400 in nba with the documented example arguments (2026-10-07).

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

Example

espn_nhl_game_leaders(event_id='401584793')

Last validated n/a.

espn_nhl_game_scoringplays

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/scoringplays

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/scoringplays

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

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

Example

espn_nhl_game_scoringplays(event_id='401584793')

Last validated n/a.

espn_nhl_game_official_detail

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/{event_id}/competitions/{cid}/officials/{official_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl/events/401584793/competitions/401584793/officials/1

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
official_id	official_id		Y		official_id path parameter.
cid	cid			Y	cid 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_name	type	description
$ref	character
display_name	character	Player display name.
first_name	character	Player first name.
full_name	character	Player full name.
id	character	Unique player identifier.
last_name	character	Player last name.
order	integer	Display order within officials list.
position_display_name	character	Position display name.
position_id	character	Official position identifier.
position_name	character	Official position name (e.g. "Referee", "Linesman").

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

Example

espn_nhl_game_official_detail(event_id='401584793', official_id='1')

Last validated n/a.