Men's college hockey — ESPN core API (v2) — Game
espn_mch_game_competition
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}
| 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 | String | |
attendance | Int64 | |
boxscore_available | Boolean | |
bracket_available | Boolean | |
commentary_available | Boolean | |
competitors | String | |
conference_competition | Boolean | |
conversation_available | Boolean | |
date | String | |
division_competition | Boolean | |
gamecast_available | Boolean | |
guid | String | |
highlights_available | Boolean | |
id | Int64 | |
lineup_available | Boolean | |
links | String | |
live_available | Boolean | |
necessary | Boolean | |
neutral_site | Boolean | |
notes | String | |
on_watch_espn | Boolean | |
pickcenter_available | Boolean | |
play_by_play_available | Boolean | |
possession_arrow_available | Boolean | |
preview_available | Boolean | |
recap_available | Boolean | |
recent | Boolean | |
series | String | |
shot_chart_available | Boolean | |
summary_available | Boolean | |
tickets_available | Boolean | |
time_valid | Boolean | |
timeouts_available | Boolean | |
uid | String | |
wallclock_available | Boolean | |
boxscore_source_description | String | |
boxscore_source_id | Int64 | |
boxscore_source_state | String | |
broadcasts_$ref | String | |
details_$ref | String | |
format_overtime_clock | Float64 | |
format_overtime_display_name | String | |
format_overtime_slug | String | |
format_regulation_clock | Float64 | |
format_regulation_display_name | String | |
format_regulation_periods | Int64 | |
format_regulation_slug | String | |
game_source_description | String | |
game_source_id | Int64 | |
game_source_state | String | |
linescore_source_description | String | |
linescore_source_id | Int64 | |
linescore_source_state | String | |
odds_$ref | String | |
officials_$ref | String | |
play_by_play_source_description | String | |
play_by_play_source_id | Int64 | |
play_by_play_source_state | String | |
power_indexes_$ref | String | |
predictor_$ref | String | |
probabilities_$ref | String | |
relevancy_$ref | String | |
situation_$ref | String | |
stats_source_description | String | |
stats_source_id | Int64 | |
stats_source_state | String | |
status_$ref | String | |
type_abbreviation | String | |
type_id | Int64 | |
type_slug | String | |
type_text | String | |
type_type | String | |
venue_$ref | String | |
venue_address_city | String | |
venue_address_state | String | |
venue_full_name | String | |
venue_grass | Boolean | |
venue_guid | String | |
venue_id | Int64 | |
venue_images | String | |
venue_indoor | Boolean |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_competition(event_id='401584793')
espn_mch_game_teams
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/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 | String | |
home_away | String | |
id | Int64 | |
order | Int64 | |
type | String | |
uid | String | |
winner | Boolean | |
leaders_$ref | String | |
linescores_$ref | String | |
record_$ref | String | |
roster_$ref | String | |
score_$ref | String | |
statistics_$ref | String | |
team_$ref | String | |
count | Int64 | Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=). |
page_count | Int64 | Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_teams(event_id='401584793')
espn_mch_game_team
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/competitors/{team_id}
| 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 | String | |
home_away | String | |
id | Int64 | |
order | Int64 | |
type | String | |
uid | String | |
winner | Boolean | |
leaders_$ref | String | |
linescores_$ref | String | |
record_$ref | String | |
roster_$ref | String | |
score_$ref | String | |
statistics_$ref | String | |
team_$ref | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_team(event_id='401584793', team_id='4')
espn_mch_game_team_roster
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/competitors/{team_id}/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 | String | |
active | Boolean | |
starter | Boolean | |
did_not_play | Boolean | |
ejected | Boolean |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_team_roster(event_id='401584793', team_id='4')
espn_mch_game_team_linescores
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/competitors/{team_id}/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.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_team_linescores(event_id='401584793', team_id='4')
espn_mch_game_team_statistics
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/competitors/{team_id}/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) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
split_name | String | Name of the stat split (Core v2 answers one, "All Splits"). |
category_name | String | ESPN stat category of the row (e.g., "defensive", "general", "offensive"). |
stat_name | String | ESPN stat key in camelCase (e.g., "blocks", "defensiveRebounds"). |
stat_abbreviation | String | Short label of the stat (e.g., "BLK"). |
stat_value | Float64 | Numeric value of the team's stat in this game. |
stat_display_value | String | The value as ESPN displays it (a string, e.g., "7"). |
stat_description | String | ESPN's one-sentence definition of the stat. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_team_statistics(event_id='401584793', team_id='4')
espn_mch_game_team_record
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/competitors/{team_id}/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.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_team_record(event_id='401584793', team_id='4')
espn_mch_game_team_leaders
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/competitors/{team_id}/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.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_team_leaders(event_id='401584793', team_id='4')
espn_mch_game_odds
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/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 | String | |
details | String | |
moneyline_winner | Boolean | |
over_odds | Float64 | |
over_under | Float64 | |
spread | Float64 | |
spread_winner | Boolean | |
under_odds | Float64 | |
away_team_odds_close_money_line_alternate_display_value | String | |
away_team_odds_close_money_line_american | String | |
away_team_odds_close_money_line_decimal | Float64 | |
away_team_odds_close_money_line_display_value | String | |
away_team_odds_close_money_line_fraction | String | |
away_team_odds_close_money_line_value | Float64 | |
away_team_odds_close_point_spread_alternate_display_value | String | |
away_team_odds_close_point_spread_american | String | |
away_team_odds_close_spread_alternate_display_value | String | |
away_team_odds_close_spread_american | String | |
away_team_odds_close_spread_decimal | Float64 | |
away_team_odds_close_spread_display_value | String | |
away_team_odds_close_spread_fraction | String | |
away_team_odds_close_spread_value | Float64 | |
away_team_odds_current_money_line_alternate_display_value | String | |
away_team_odds_current_money_line_american | String | |
away_team_odds_current_money_line_decimal | Float64 | |
away_team_odds_current_money_line_display_value | String | |
away_team_odds_current_money_line_fraction | String | |
away_team_odds_current_money_line_value | Float64 | |
away_team_odds_current_point_spread_alternate_display_value | String | |
away_team_odds_current_point_spread_american | String | |
away_team_odds_current_spread_alternate_display_value | String | |
away_team_odds_current_spread_american | String | |
away_team_odds_current_spread_decimal | Float64 | |
away_team_odds_current_spread_display_value | String | |
away_team_odds_current_spread_fraction | String | |
away_team_odds_current_spread_value | Float64 | |
away_team_odds_favorite | Boolean | |
away_team_odds_money_line | Int64 | |
away_team_odds_open_favorite | Boolean | |
away_team_odds_open_money_line_alternate_display_value | String | |
away_team_odds_open_money_line_american | String | |
away_team_odds_open_money_line_decimal | Float64 | |
away_team_odds_open_money_line_display_value | String | |
away_team_odds_open_money_line_fraction | String | |
away_team_odds_open_money_line_value | Float64 | |
away_team_odds_open_point_spread_alternate_display_value | String | |
away_team_odds_open_point_spread_american | String | |
away_team_odds_open_spread_alternate_display_value | String | |
away_team_odds_open_spread_american | String | |
away_team_odds_open_spread_decimal | Float64 | |
away_team_odds_open_spread_display_value | String | |
away_team_odds_open_spread_fraction | String | |
away_team_odds_open_spread_value | Float64 | |
away_team_odds_spread_odds | Float64 | |
away_team_odds_team_$ref | String | |
away_team_odds_underdog | Boolean | |
close_over_alternate_display_value | String | |
close_over_american | String | |
close_over_decimal | Float64 | |
close_over_display_value | String | |
close_over_fraction | String | |
close_over_value | Float64 | |
close_total_alternate_display_value | String | |
close_total_american | String | |
close_total_decimal | Float64 | |
close_total_display_value | String | |
close_total_fraction | String | |
close_total_value | Float64 | |
close_under_alternate_display_value | String | |
close_under_american | String | |
close_under_decimal | Float64 | |
close_under_display_value | String | |
close_under_fraction | String | |
close_under_value | Float64 | |
current_over_alternate_display_value | String | |
current_over_american | String | |
current_over_decimal | Float64 | |
current_over_display_value | String | |
current_over_fraction | String | |
current_over_value | Float64 | |
current_total_alternate_display_value | String | |
current_total_american | String | |
current_total_decimal | Float64 | |
current_total_display_value | String | |
current_total_fraction | String | |
current_total_value | Float64 | |
current_under_alternate_display_value | String | |
current_under_american | String | |
current_under_decimal | Float64 | |
current_under_display_value | String | |
current_under_fraction | String | |
current_under_value | Float64 | |
home_team_odds_close_money_line_alternate_display_value | String | |
home_team_odds_close_money_line_american | String | |
home_team_odds_close_money_line_decimal | Float64 | |
home_team_odds_close_money_line_display_value | String | |
home_team_odds_close_money_line_fraction | String | |
home_team_odds_close_money_line_value | Float64 | |
home_team_odds_close_point_spread_alternate_display_value | String | |
home_team_odds_close_point_spread_american | String | |
home_team_odds_close_point_spread_decimal | Float64 | |
home_team_odds_close_point_spread_display_value | String | |
home_team_odds_close_point_spread_fraction | String | |
home_team_odds_close_point_spread_value | Float64 | |
home_team_odds_close_spread_alternate_display_value | String | |
home_team_odds_close_spread_american | String | |
home_team_odds_close_spread_decimal | Float64 | |
home_team_odds_close_spread_display_value | String | |
home_team_odds_close_spread_fraction | String | |
home_team_odds_close_spread_value | Float64 | |
home_team_odds_current_money_line_alternate_display_value | String | |
home_team_odds_current_money_line_american | String | |
home_team_odds_current_money_line_decimal | Float64 | |
home_team_odds_current_money_line_display_value | String | |
home_team_odds_current_money_line_fraction | String | |
home_team_odds_current_money_line_value | Float64 | |
home_team_odds_current_point_spread_alternate_display_value | String | |
home_team_odds_current_point_spread_american | String | |
home_team_odds_current_point_spread_decimal | Float64 | |
home_team_odds_current_point_spread_display_value | String | |
home_team_odds_current_point_spread_fraction | String | |
home_team_odds_current_point_spread_value | Float64 | |
home_team_odds_current_spread_alternate_display_value | String | |
home_team_odds_current_spread_american | String | |
home_team_odds_current_spread_decimal | Float64 | |
home_team_odds_current_spread_display_value | String | |
home_team_odds_current_spread_fraction | String | |
home_team_odds_current_spread_value | Float64 | |
home_team_odds_favorite | Boolean | |
home_team_odds_money_line | Int64 | |
home_team_odds_open_favorite | Boolean | |
home_team_odds_open_money_line_alternate_display_value | String | |
home_team_odds_open_money_line_american | String | |
home_team_odds_open_money_line_decimal | Float64 | |
home_team_odds_open_money_line_display_value | String | |
home_team_odds_open_money_line_fraction | String | |
home_team_odds_open_money_line_value | Float64 | |
home_team_odds_open_point_spread_alternate_display_value | String | |
home_team_odds_open_point_spread_american | String | |
home_team_odds_open_point_spread_decimal | Float64 | |
home_team_odds_open_point_spread_display_value | String | |
home_team_odds_open_point_spread_fraction | String | |
home_team_odds_open_point_spread_value | Float64 | |
home_team_odds_open_spread_alternate_display_value | String | |
home_team_odds_open_spread_american | String | |
home_team_odds_open_spread_decimal | Float64 | |
home_team_odds_open_spread_display_value | String | |
home_team_odds_open_spread_fraction | String | |
home_team_odds_open_spread_value | Float64 | |
home_team_odds_spread_odds | Float64 | |
home_team_odds_team_$ref | String | |
home_team_odds_underdog | Boolean | |
open_over_alternate_display_value | String | |
open_over_american | String | |
open_over_decimal | Float64 | |
open_over_display_value | String | |
open_over_fraction | String | |
open_over_value | Float64 | |
open_total_alternate_display_value | String | |
open_total_american | String | |
open_total_decimal | Float64 | |
open_total_display_value | String | |
open_total_fraction | String | |
open_total_value | Float64 | |
open_under_alternate_display_value | String | |
open_under_american | String | |
open_under_decimal | Float64 | |
open_under_display_value | String | |
open_under_fraction | String | |
open_under_value | Float64 | |
provider_$ref | String | |
provider_id | Int64 | |
provider_name | String | |
provider_priority | Int64 | |
prop_bets_$ref | String | |
count | Int64 | Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=). |
page_count | Int64 | Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_odds(event_id='401584793')
espn_mch_game_probabilities
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/probabilities
| 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 | String | |
away_win_percentage | Float64 | |
home_win_percentage | Float64 | |
last_modified | String | |
sequence_number | String | |
spread_cover_prob_home | Float64 | |
spread_push_prob | Float64 | |
tie_percentage | Float64 | |
total_over_prob | Float64 | |
away_team_$ref | String | |
competition_$ref | String | |
home_team_$ref | String | |
play_$ref | String | |
source_description | String | |
source_id | Int64 | |
source_state | String | |
count | Int64 | Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=). |
page_count | Int64 | Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_probabilities(event_id='401584793')
espn_mch_game_plays
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/plays
| 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 | String | |
alternative_text | String | |
away_score | Int64 | |
clock_display_value | String | |
clock_value | Float64 | |
coordinate_x | Int64 | |
coordinate_y | Int64 | |
home_score | Int64 | |
id | Int64 | |
modified | String | |
period_display_value | String | |
period_number | Int64 | |
points_attempted | Int64 | |
priority | Boolean | |
probability_$ref | String | |
score_value | Int64 | |
scoring_play | Boolean | |
sequence_number | String | |
shooting_play | Boolean | |
team_$ref | String | |
text | String | |
type_id | Int64 | |
type_text | String | |
valid | Boolean | |
wallclock | String | |
short_alternative_text | String | |
short_text | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_plays(event_id='401584793')
espn_mch_game_play
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/plays/{play_id}
| 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 | String | |
alternative_text | String | |
away_score | Int64 | |
home_score | Int64 | |
id | Int64 | |
modified | String | |
participants | String | |
points_attempted | Int64 | |
priority | Boolean | |
score_value | Int64 | |
scoring_play | Boolean | |
sequence_number | String | |
shooting_play | Boolean | |
text | String | |
valid | Boolean | |
wallclock | String | |
clock_display_value | String | |
clock_value | Float64 | |
coordinate_x | Int64 | |
coordinate_y | Int64 | |
period_display_value | String | |
period_number | Int64 | |
probability_$ref | String | |
team_$ref | String | |
type_id | Int64 | |
type_text | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_play(event_id='401584793', play_id='1')
espn_mch_game_play_personnel
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/plays/{play_id}/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.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_play_personnel(event_id='401584793', play_id='1')
espn_mch_game_situation
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/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 | String | |
away_fouls_bonus_state | String | |
away_fouls_fouls_to_give | Int64 | |
away_fouls_team_fouls | Int64 | |
away_fouls_team_fouls_current | Int64 | |
away_timeouts_timeouts_current | Int64 | |
away_timeouts_timeouts_remaining_current | Int64 | |
home_fouls_bonus_state | String | |
home_fouls_fouls_to_give | Int64 | |
home_fouls_team_fouls | Int64 | |
home_fouls_team_fouls_current | Int64 | |
home_timeouts_timeouts_current | Int64 | |
home_timeouts_timeouts_remaining_current | Int64 | |
last_play_$ref | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_situation(event_id='401584793')
espn_mch_game_status
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/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 | String | |
clock | Float64 | |
display_clock | String | |
period | Int64 | |
type_completed | Boolean | |
type_description | String | |
type_detail | String | |
type_id | Int64 | |
type_name | String | |
type_short_detail | String | |
type_state | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_status(event_id='401584793')
espn_mch_game_officials
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/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 | String | |
display_name | String | |
first_name | String | |
full_name | String | |
id | Int64 | |
last_name | String | |
order | Int64 | |
position_display_name | String | |
position_id | Int64 | |
position_name | String | |
count | Int64 | Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=). |
page_count | Int64 | Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_officials(event_id='401584793')
espn_mch_game_broadcasts
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/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 | Int64 | |
lang | String | |
partnered | Boolean | |
priority | Int64 | |
region | String | |
slug | String | |
station | String | |
competition_$ref | String | |
market_id | Int64 | |
market_type | String | |
media_$ref | String | |
media_call_letters | String | |
media_id | Int64 | |
media_logos | String | |
media_name | String | |
media_short_name | String | |
media_slug | String | |
type_id | Int64 | |
type_long_name | String | |
type_short_name | String | |
type_slug | String | |
count | Int64 | Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=). |
page_count | Int64 | Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_broadcasts(event_id='401584793')
espn_mch_game_predictor
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/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 | String | |
last_modified | String | |
name | String | |
short_name | String | |
away_team_statistics | String | |
away_team_team_$ref | String | |
home_team_team_$ref | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_predictor(event_id='401584793')
espn_mch_game_powerindex
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/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 | Int64 | |
items | String | |
page_count | Int64 | |
page_index | Int64 | |
page_size | Int64 |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_powerindex(event_id='401584793')
espn_mch_game_propbets
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/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.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_propbets(event_id='401584793')
espn_mch_game_leaders
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/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.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_leaders(event_id='401584793')
espn_mch_game_scoringplays
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/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.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_scoringplays(event_id='401584793')
espn_mch_game_official_detail
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}/competitions/{cid}/officials/{official_id}
| 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 | String | |
display_name | String | |
first_name | String | |
full_name | String | |
id | Int64 | |
last_name | String | |
order | Int64 | |
position_display_name | String | |
position_id | Int64 | |
position_name | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. |
Example
espn_mch_game_official_detail(event_id='401584793', official_id='1')