Men's college hockey — ESPN core API (v2) — Other
espn_mch_league_root
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|
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 | |
abbreviation | String | |
color | String | |
display_name | String | |
gender | String | |
guid | String | |
id | Int64 | |
is_tournament | Boolean | |
links | String | |
logos | String | |
name | String | |
short_name | String | |
slug | String | |
uid | String | |
athletes_$ref | String | |
awards_$ref | String | |
calendar_$ref | String | |
draft_$ref | String | |
events_$ref | String | |
franchises_$ref | String | |
group_$ref | String | |
groups_$ref | String | |
leaders_$ref | String | |
notes_$ref | String | |
rankings_$ref | String | |
season_$ref | String | |
season_athletes_$ref | String | |
season_coaches_$ref | String | |
season_display_name | String | |
season_end_date | String | |
season_futures_$ref | String | |
season_power_index_leaders_$ref | String | |
season_power_indexes_$ref | String | |
season_rankings_$ref | String | |
season_start_date | String | |
season_type_$ref | String | |
season_type_abbreviation | String | |
season_type_corrections_$ref | String | |
season_type_end_date | String | |
season_type_groups_$ref | String | |
season_type_has_groups | Boolean | |
season_type_has_legs | Boolean | |
season_type_has_standings | Boolean | |
season_type_id | Int64 | |
season_type_name | String | |
season_type_slug | String | |
season_type_start_date | String | |
season_type_type | Int64 | |
season_type_weeks_$ref | String | |
season_type_year | Int64 | |
season_types_$ref | String | |
season_types_count | Int64 | |
season_types_items | String | |
season_types_page_count | Int64 | |
season_types_page_index | Int64 | |
season_types_page_size | Int64 | |
season_year | Int64 | |
seasons_$ref | String | |
teams_$ref | String | |
transactions_$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_league_root()
espn_mch_seasons
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/seasons
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/seasons?limit=200
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
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 | |
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_seasons()
espn_mch_games
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events?limit=500
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
dates | dates | Y | Date or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD). | ||
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 | |
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_games()
espn_mch_game
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/{event_id}
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/events/401584793
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
event_id | event_id | Y | event_id path parameter. |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
$ref | String | |
competitions | String | |
date | String | |
id | Int64 | |
links | String | |
name | String | |
short_name | String | |
time_valid | Boolean | |
uid | String | |
venues | String | |
league_$ref | String | |
season_$ref | String | |
season_type_$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(event_id='401584793')
espn_mch_teams_core
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/teams
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
limit | limit | Y | Maximum number of items to return. | ||
page | page | Y | page query 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 |
|---|---|---|
team_abbreviation | String | Short team abbreviation (e.g. "BOS"). |
team_alternate_color | String | Secondary team color as a hex string (no leading '#'). |
team_color | String | Primary team color as a hex string (no leading '#'). |
team_display_name | String | Full team display name (location + nickname). |
team_id | Int64 | ESPN team id (stable join key across ESPN endpoints). |
team_is_active | Boolean | Whether the team is currently active. |
team_is_all_star | Boolean | Whether the entry is an all-star squad rather than a franchise. |
team_location | String | Team location / city (e.g. "Boston"). |
team_logos | String | Pipe-delimited logo image URLs. |
team_name | String | Team nickname/mascot (e.g. "Celtics"). |
team_nickname | String | Team nickname as ESPN labels it (often equals team_name). |
team_short_display_name | String | Abbreviated display name for compact UIs. |
team_slug | String | URL slug used in ESPN web paths. |
team_uid | String | ESPN global UID (encodes sport/league/team). |
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_teams_core()
espn_mch_team_core
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/teams/{team_id}
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/teams/4
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
team_id | team_id | Y | team_id path parameter. |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
$ref | String | |
abbreviation | String | |
alternate_color | String | |
color | String | |
display_name | String | |
guid | String | |
id | Int64 | |
is_active | Boolean | |
is_all_star | Boolean | |
links | String | |
location | String | |
logos | String | |
name | String | |
short_display_name | String | |
slug | String | |
uid | String | |
against_the_spread_records_$ref | String | |
athletes_$ref | String | |
awards_$ref | String | |
coaches_$ref | String | |
depth_charts_$ref | String | |
events_$ref | String | |
franchise_$ref | String | |
groups_$ref | String | |
injuries_$ref | String | |
notes_$ref | String | |
odds_records_$ref | String | |
ranks_$ref | String | |
record_$ref | String | |
transactions_$ref | 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 | |
venue_short_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_team_core(team_id='4')
espn_mch_venues
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/venues
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/venues?limit=1000
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
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 | |
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_venues()
espn_mch_venue
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/venues/{venue_id}
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/venues/3663
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
venue_id | venue_id | Y | venue_id path parameter. |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
$ref | String | |
full_name | String | |
grass | Boolean | |
guid | String | |
id | Int64 | |
images | String | |
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_venue(venue_id='3663')
espn_mch_franchises
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/franchises
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/franchises?limit=200
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
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 | |
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_franchises()
espn_mch_franchise
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/franchises/{franchise_id}
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/franchises/2
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
franchise_id | franchise_id | Y | franchise_id path parameter. |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
$ref | String | |
abbreviation | String | |
color | String | |
display_name | String | |
id | Int64 | |
is_active | Boolean | |
location | String | |
name | String | |
short_display_name | String | |
slug | String | |
uid | String | |
team_$ref | 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 | |
venue_short_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_franchise(franchise_id='2')
espn_mch_coach
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/coaches/{coach_id}
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/coaches/1
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
coach_id | coach_id | Y | coach_id path parameter. |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
$ref | String | |
career_records | String | |
coach_seasons | String | |
experience | Int64 | |
first_name | String | |
id | Int64 | |
last_name | String | |
uid | String | |
birth_place_city | String | |
birth_place_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_coach(coach_id='1')
espn_mch_coach_record
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/coaches/{coach_id}/record/{record_type}
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/coaches/1/record/0
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
coach_id | coach_id | Y | coach_id path parameter. | ||
record_type | record_type | Y | record_type 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_value | String | |
id | Int64 | |
name | String | |
stats | String | |
summary | String | |
type | String | |
value | Float64 |
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_coach_record(coach_id='1')
espn_mch_coach_season
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/coaches/{coach_id}/seasons/{season}
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/coaches/1/seasons/2024
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
coach_id | coach_id | Y | coach_id path parameter. | ||
season | season | Y | season 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_coach_season(coach_id='1', season=2024)
espn_mch_positions
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/positions
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/positions?limit=200
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
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 | |
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_positions()
espn_mch_position
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/positions/{position_id}
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/positions/1
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
position_id | position_id | Y | position_id path parameter. |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
$ref | String | |
abbreviation | String | |
display_name | String | |
id | Int64 | |
leaf | Boolean | |
name | String | |
parent_$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_position(position_id='1')
espn_mch_tournaments
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/tournaments
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/tournaments?limit=200
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
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 | |
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_tournaments()
espn_mch_awards
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/awards
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/awards?limit=200
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
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 | |
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_awards()
espn_mch_award
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/awards/{award_id}
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/awards/1
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
award_id | award_id | Y | award_id path parameter. |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_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_award(award_id='1')
espn_mch_standings_core
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/standings
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/standings
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|
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 |
|---|---|---|
group_name | String | Group name. |
group_abbreviation | String | Group abbreviation. |
team_id | Int64 | Team id. |
team_name | String | Team name. |
team_abbreviation | String | Team abbreviation. |
team_display_name | String | Team display name. |
team_location | String | Team location. |
team_logo | String | Team logo. |
avg_points_against | Float64 | Avg points against. |
avg_points_for | Float64 | Avg points for. |
clincher | Float64 | Clincher. |
differential | Float64 | Differential. |
division_win_percent | Float64 | Division win percent. |
games_behind | Float64 | Games behind. |
league_win_percent | Float64 | League win percent. |
losses | Float64 | Losses. |
playoff_seed | Float64 | Playoff seed. |
point_differential | Float64 | Point differential. |
points | Float64 | Points. |
points_against | Float64 | Points against. |
points_for | Float64 | Points for. |
streak | Float64 | Streak. |
win_percent | Float64 | Win percent. |
wins | Float64 | Wins. |
games_ahead | Float64 | Games ahead. |
overall | String | Overall. |
home | String | Home. |
road | String | Road. |
vs. div. | String | Vs. div.. |
vs. conf. | String | Vs. conf.. |
last ten games | String | Last ten games. |
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_standings_core()
espn_mch_leaders_core
All-time league leaders. ESPN ignores season here (nba with and without season=2015 returned the same career totals, 2026-11-17).
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/leaders
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/leaders
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|
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, nfl, mlb, nhl, 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_leaders_core()
espn_mch_league_notes
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/notes
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/notes
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|
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: the page holds zero items (count 0) 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_league_notes()
espn_mch_talentpicks
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/talentpicks
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/talentpicks
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|
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 |
|---|---|---|
pick_competition_$ref | String | |
pick_competitor_$ref | String | |
pick_correct | Boolean | |
pick_person_display_name | String | |
pick_person_first_name | String | |
pick_person_headshot_alt | String | |
pick_person_headshot_href | String | |
pick_person_id | Int64 | |
pick_person_last_name | String | |
week_record_display_value | String | |
week_record_season_$ref | String | |
week_record_stats | 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_talentpicks()
espn_mch_recruiting_years
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/recruiting
Valid URL: https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/recruiting
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|
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 | |
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_recruiting_years()
espn_mch_recruiting_players
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/recruiting/{year}/athletes
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
year | year | Y | year path parameter. | ||
limit | limit | Y | Maximum number of items to return. | ||
page | page | Y | page query 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 | |
activity | String | |
analysis | String | |
attributes | String | |
grade | Int64 | |
grade_display_value | String | |
recruiting_class | Int64 | |
schools | String | |
athlete_alternate_id | Int64 | |
athlete_display_name | String | |
athlete_first_name | String | |
athlete_full_name | String | |
athlete_height | Float64 | |
athlete_high_school_address_address1 | String | |
athlete_high_school_address_city | String | |
athlete_high_school_address_state | String | |
athlete_high_school_address_state_abbreviation | String | |
athlete_high_school_address_zip_code | String | |
athlete_high_school_id | Int64 | |
athlete_high_school_name | String | |
athlete_high_school_proper_name | String | |
athlete_hometown_city | String | |
athlete_hometown_state | String | |
athlete_hometown_state_abbreviation | String | |
athlete_id | Int64 | |
athlete_last_name | String | |
athlete_links | String | |
athlete_position_abbreviation | String | |
athlete_position_id | Int64 | |
athlete_short_name | String | |
athlete_weight | Float64 | |
status_description | String | |
status_id | Int64 | |
athlete_hometown_zip_code | 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_recruiting_players(year=2026)
espn_mch_recruiting_rankings
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/hockey/leagues/mens-college-hockey/recruiting/{year}/rankings
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
year | year | Y | year 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 | |
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_recruiting_rankings(year=2026)