
Get ESPN MCH / WCH Season Free Agents (core-v2)
Source:R/espn_ncaa_hockey.R
espn_mch_season_freeagents.RdGet ESPN MCH / WCH Season Free Agents (core-v2)
Usage
espn_mch_season_freeagents(season = most_recent_nhl_season(), limit = 100, ...)
espn_wch_season_freeagents(season = most_recent_nhl_season(), limit = 100, ...)Arguments
- season
Season end-year (e.g.
2026). Defaults tomost_recent_nhl_season().- limit
Maximum number of free agents to return (default
100).- ...
Reserved for forward compatibility.
Value
A fastRhockey_data tibble with one row per free-agent athlete
reference. Note: The MCH free-agents endpoint (seasons/{season}/freeagents)
currently returns count=0 for all tested seasons - the endpoint exists
but ESPN does not populate it for MCH. An empty tibble is returned
gracefully in that case:
| col_name | types | description |
| ref | character | $ref URL for the athlete-in-season object. |
| athlete_id | character | ESPN athlete id parsed from the $ref URL. |
| season | integer | Season year (echoed from arg). |
| count | integer | Total free agents in the collection (typically 0). |
| page_count | integer | Total pages in the collection. |
Details
League slug mens-college-hockey; season is the END year (2026 = 2025-26). Same ESPN helper as espn_nhl_season_freeagents() (columns inherited); a collection may be empty.
espn_wch_season_freeagents() is the same wrapper for women's college hockey
(league slug womens-college-hockey): same arguments, same columns.
See also
family_espn_mch lists every function in this family.
Examples
# \donttest{
# NOTE: Returns empty tibble for MCH (ESPN does not populate this endpoint)
try(espn_mch_season_freeagents(season = 2026))
#> data frame with 0 columns and 0 rows
# }
# \donttest{
# NOTE: Returns empty tibble for WCH (ESPN does not populate this endpoint)
try(espn_wch_season_freeagents(season = 2026))
#> data frame with 0 columns and 0 rows
# }