NHL Records - Players by Team — nhl_records_player

Returns every player who has suited up for a given team via the NHL Records API (https://records.nhl.com/site/api/player/byTeam/{team_id}).

Usage

nhl_records_player_byteam(team_id, cayenne_exp = NULL)

Arguments

team_id: Integer team ID (required).
cayenne_exp: Optional Cayenne filter expression string.

Value

A data frame (fastRhockey_data) with the following columns:

col_name	types	description
id	integer	Unique player identifier.
accrued_seasons	integer	Number of accrued NHL seasons.
add_names	logical	Additional names for the player.
age_sign_waiver	integer	Age at which the player signed a waiver.
age_signel_fa	integer	Age at which the player signed as a free agent.
alert	character	Alert flag or note.
birth_city	character	Birth city of the player.
birth_country	character	Birth country of the player.
birth_date	character	Birth date of the player.
birth_state_province	character	Birth state or province of the player.
career_team_id	logical	Primary career team identifier.
central_registry_position	character	Position per the central registry.
club_elec_arb	character	Club election to arbitration indicator.
current_team_id	integer	Current team identifier.
date_of_death	logical	Date of death, if applicable.
dda_id	integer	DDA identifier.
deceased	logical	Whether the player is deceased.
ep_player_id	integer	EliteProspects player identifier.
fa_group_after_season	logical	Free agent group after the season.
first_name	character	First name of the player.
first_signed_by_team_id	integer	Team that first signed the player.
free_agent_group	character	Free agent group classification.
full_name	character	Full name of the player.
group5election	character	Group 5 free agency election indicator.
group5seasons_earned	integer	Group 5 seasons earned.
group6proration	logical	Group 6 proration indicator.
group6seasons_earned	integer	Group 6 seasons earned.
groups_earned_thru_season	integer	Season through which groups were earned.
height	integer	Player height in inches.
hof_induction_year	logical	Hockey Hall of Fame induction year.
home_town	character	Home town of the player.
iihf_hof_induction_year	logical	IIHF Hall of Fame induction year.
in_hockey_hof	logical	Whether the player is in the Hockey Hall of Fame.
in_iihf_hof	integer	Whether the player is in the IIHF Hall of Fame.
in_top100alltime	logical	Whether the player is in the all-time top 100.
in_us_hockey_hof	logical	Whether the player is in the US Hockey Hall of Fame.
is_defected	character	Whether the player defected.
is_deleted	character	Whether the record is deleted.
is_junior	character	Whether the player is a junior.
is_retired	logical	Whether the player is retired.
is_rookie	character	Whether the player is a rookie.
is_suspended	character	Whether the player is suspended.
last_amateur_league_id	integer	Last amateur league identifier.
last_amateur_team_id	integer	Last amateur team identifier.
last_nhl_team_id	integer	Last NHL team identifier.
last_name	character	Last name of the player.
loan_cap_exception	character	Loan cap exception indicator.
long_term_injury	character	Long-term injury indicator.
message	character	Status message.
middle_name	character	Middle name of the player.
nationality	character	Nationality of the player.
nhl_experience	integer	Years of NHL experience.
on_roster	character	Whether the player is on a roster.
platform_year	integer	Platform year for contract purposes.
position	character	Player position.
pr_name	character	Public relations display name.
pr_stat	integer	Public relations status code.
pro_year_reduction	integer	Professional year reduction.
reentry_waivers	character	Re-entry waivers indicator.
roster_special_code	logical	Roster special status code.
salary_arbitration_exp	integer	Salary arbitration experience.
shoots_catches	character	Handedness (shoots or catches).
sweater_number	integer	Sweater number worn by the player.
update_timestamp	character	Timestamp of the last record update.
us_hof_induction_year	logical	US Hockey Hall of Fame induction year.
vet_cap_excptn	character	Veteran cap exception indicator.
waiver_amount	integer	Waiver amount.
waiver_draft	character	Waiver draft indicator.
waiver_status	character	Waiver status.
weight	integer	Player weight in pounds.
years_pro	integer	Number of professional years played.

Examples

# \donttest{
  try(nhl_records_player_byteam(team_id = 10))
#> ── NHL Records Player by Team ───────────────────────────── fastRhockey 1.0.0 ──
#> ℹ Data updated: 2026-06-13 03:25:46 UTC
#> # A tibble: 71 × 71
#>         id accrued_seasons add_names age_sign_waiver age_signel_fa alert
#>      <int>           <int> <lgl>               <int>         <int> <chr>
#>  1 8475690              13 NA                     21            20 N    
#>  2 8476329               6 NA                     22            22 N    
#>  3 8476988               8 NA                     22            22 Y    
#>  4 8477541               2 NA                     21            21 N    
#>  5 8479528              NA NA                     NA            NA N    
#>  6 8479543               4 NA                     20            20 Y    
#>  7 8479599              NA NA                     NA            NA N    
#>  8 8479968               2 NA                     22            22 N    
#>  9 8480284              NA NA                     NA            NA N    
#> 10 8480870               1 NA                     19            19 N    
#> # ℹ 61 more rows
#> # ℹ 65 more variables: birth_city <chr>, birth_country <chr>, birth_date <chr>,
#> #   birth_state_province <chr>, career_team_id <lgl>,
#> #   central_registry_position <chr>, club_elec_arb <chr>,
#> #   current_team_id <int>, date_of_death <lgl>, dda_id <int>, deceased <lgl>,
#> #   ep_player_id <int>, fa_group_after_season <lgl>, first_name <chr>,
#> #   first_signed_by_team_id <int>, free_agent_group <chr>, full_name <chr>, …
# }