Skip to contents

Get ESPN NHL Season Free Agents (core-v2)

Usage

espn_nhl_season_freeagents(season = most_recent_nhl_season(), limit = 100, ...)

Arguments

season

Season end-year (e.g. 2026). Defaults to most_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 NHL free-agents endpoint (seasons/{season}/freeagents) currently returns count=0 for all tested seasons - the endpoint exists but ESPN does not populate it for NHL. An empty tibble is returned gracefully in that case:

col_nametypesdescription
refcharacter$ref URL for the athlete-in-season object.
athlete_idcharacterESPN athlete id parsed from the $ref URL.
seasonintegerSeason year (echoed from arg).
countintegerTotal free agents in the collection (typically 0).
page_countintegerTotal pages in the collection.

See also

family_espn_nhl lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  # NOTE: Returns empty tibble for NHL (ESPN does not populate this endpoint)
  try(espn_nhl_season_freeagents(season = 2026))
#> data frame with 0 columns and 0 rows
# }