Skip to contents

Get ESPN NHL Team Roster

Usage

espn_nhl_team_roster(team_id, ...)

Arguments

team_id

ESPN team identifier (character or numeric, e.g. "4" for Pittsburgh Penguins).

...

Reserved for forward compatibility.

Value

A fastRhockey_data tibble with one row per player:

col_nametypesdescription
position_groupcharacterPosition group name (e.g. Centers).
idcharacterESPN player identifier.
uidcharacterESPN player uid.
guidcharacterPlayer global unique identifier.
alternate_idcharacterAlternate player identifier.
alternate_ids_sdrcharacterAlternate ids sdr.
first_namecharacterFirst name.
last_namecharacterLast name.
full_namecharacterFull name.
display_namecharacterDisplay name.
short_namecharacterShort name.
weightnumericWeight (lbs).
display_weightcharacterDisplay weight string.
heightnumericHeight (inches).
display_heightcharacterDisplay height string.
ageintegerPlayer age.
date_of_birthcharacterDate of birth.
slugcharacterURL slug.
jerseycharacterJersey number.
headshot_hrefcharacterHeadshot image URL.
headshot_altcharacterHeadshot alt text.
hand_typecharacterShooting/catching hand type.
hand_abbreviationcharacterHand abbreviation.
hand_display_valuecharacterHand display value.
position_idcharacterPosition identifier.
position_namecharacterPosition name.
position_display_namecharacterPosition display name.
position_abbreviationcharacterPosition abbreviation.
position_leaflogicalWhether position is a leaf node.
position_parent_idcharacterParent position identifier.
position_parent_namecharacterParent position name.
position_parent_display_namecharacterParent position display name.
position_parent_abbreviationcharacterParent position abbreviation.
position_parent_leaflogicalWhether parent position is leaf.
experience_yearsintegerExperience years.
debut_yearnumericDebut year.
status_idcharacterStatus identifier.
status_namecharacterStatus name.
status_typecharacterStatus type.
status_abbreviationcharacterStatus abbreviation.
birth_place_citycharacterBirth place city.
birth_place_statecharacterBirth place state.
birth_place_countrycharacterBirth place country.
birth_place_display_textcharacterBirth place display text.
birth_country_abbreviationcharacterBirth country abbreviation.
college_idcharacterCollege identifier.
college_guidcharacterCollege guid.
college_mascotcharacterCollege mascot.
college_namecharacterCollege name.
college_short_namecharacterCollege short name.
college_abbrevcharacterCollege abbreviation.
college_logoscharacterCollege logo URLs (pipe-delimited).
team_idcharacterESPN team identifier (from arg).

See also

family_espn_nhl lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  try(espn_nhl_team_roster(team_id = "4"))
#> ── NHL Team Roster data from ESPN.com ───────────────────── fastRhockey 1.1.0 ──
#> ℹ Data updated: 2026-11-13 21:27:52 UTC
#> # A tibble: 25 × 53
#>    position_group id      uid    guid  alternate_id alternate_ids_sdr first_name
#>    <chr>          <chr>   <chr>  <chr> <chr>        <chr>             <chr>     
#>  1 Centers        5149125 s:70~… 81dd… 5149125      5149125           Connor    
#>  2 Centers        3115033 s:70~… 73cf… 3115033      3115033           Ryan      
#>  3 Centers        5291935 s:70~… a477… 5291935      5291935           Anton     
#>  4 Centers        5080227 s:70~… 0825… 5080227      5080227           Ryan      
#>  5 Centers        5149194 s:70~… 4852… 5149194      5149194           Oliver    
#>  6 Centers        5080157 s:70~… eaef… 5080157      5080157           Frank     
#>  7 Centers        2592095 s:70~… 527b… 2592095      2592095           Teuvo     
#>  8 Left Wings     3042056 s:70~… 5075… 3042056      3042056           Tyler     
#>  9 Left Wings     5090524 s:70~… bce2… 5090524      5090524           Dillon    
#> 10 Left Wings     3900260 s:70~… 16ee… 3900260      3900260           Jordan    
#> # ℹ 15 more rows
#> # ℹ 46 more variables: last_name <chr>, full_name <chr>, display_name <chr>,
#> #   short_name <chr>, weight <dbl>, display_weight <chr>, height <dbl>,
#> #   display_height <chr>, age <int>, date_of_birth <chr>, slug <chr>,
#> #   jersey <chr>, headshot_href <chr>, headshot_alt <chr>, hand_type <chr>,
#> #   hand_abbreviation <chr>, hand_display_value <chr>, position_id <chr>,
#> #   position_name <chr>, position_display_name <chr>, …
# }