Skip to contents

Get ESPN MCH / WCH Team Roster

Usage

espn_mch_team_roster(team_id, limit = 500, ...)

espn_wch_team_roster(team_id, limit = 500, ...)

Arguments

team_id

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

limit

Maximum number of athletes (ESPN limit; default 500, as sportsdataverse-py).

...

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).

Details

League slug mens-college-hockey; season is the END year (2026 = 2025-26). Same ESPN helper as espn_nhl_team_roster(); ESPN answered an empty collection for every captured MCH body (2026-10), so the columns below are the NHL helper's and unverified for this league.

espn_wch_team_roster() 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.

Author

Saiem Gilani

Examples

# \donttest{
  try(espn_mch_team_roster(team_id = "104"))
#> ✖ 2026-11-13 21:26:44.279636: Invalid arguments or no ESPN mens-college-hockey team roster data available!
#> ✖ Args: league = "mens-college-hockey", team_id = "104", limit = 500
#> ✖ Error: arguments imply differing number of rows: 1, 0
#> data frame with 0 columns and 0 rows
# }
# \donttest{
  try(espn_wch_team_roster(team_id = "2137"))
#> data frame with 0 columns and 0 rows
# }