Skip to contents

Get ESPN MCH / WCH Scoreboard

Usage

espn_mch_scoreboard(
  dates = NULL,
  week = NULL,
  season_type = NULL,
  groups = NULL,
  limit = 500,
  ...
)

espn_wch_scoreboard(
  dates = NULL,
  week = NULL,
  season_type = NULL,
  groups = NULL,
  limit = 500,
  ...
)

Arguments

dates

Optional date or date-range string in "YYYYMMDD" or "YYYYMMDD-YYYYMMDD" format. When NULL (default) the current day is used.

week

Optional week number (ESPN week query).

season_type

Optional season phase (1 = pre, 2 = regular, 3 = post); sent as seasontype.

groups

Optional conference/group id filter.

limit

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

...

Reserved for forward compatibility.

Value

A fastRhockey_data tibble with one row per game:

col_nametypedescription
game_idcharacterESPN event identifier.
uidcharacterESPN event uid.
datecharacterGame date-time (ISO 8601).
namecharacterFull game name.
short_namecharacterShort game name.
season_yearintegerSeason end year.
season_typeintegerSeason type code (1=pre, 2=regular, 3=post).
season_slugcharacterSeason type slug.
status_type_idcharacterStatus type identifier.
status_type_namecharacterStatus type name.
status_type_statecharacterStatus state (pre/in/post).
status_type_completedlogicalWhether the game is complete.
status_type_descriptioncharacterStatus description.
status_type_detailcharacterStatus detail text.
status_type_short_detailcharacterShort status detail.
status_clocknumericGame clock in seconds.
status_display_clockcharacterDisplay clock string.
status_periodintegerCurrent period.
neutral_sitelogicalWhether the game is at a neutral site.
conference_competitioncharacterWhether it is a conference competition.
attendanceintegerGame attendance.
venue_idcharacterESPN venue identifier.
venue_full_namecharacterVenue full name.
venue_citycharacterVenue city.
venue_statecharacterVenue state.
venue_indoorlogicalWhether the venue is indoors.
broadcastcharacterEvery network name, feed order, deduped, joined with ", " (e.g. "ESPNU, ESPN+"); a broadcast without names gives its market; "" when none.
notecharacterGame note or headline.
home_idcharacterHome team ESPN identifier.
home_namecharacterHome team name.
home_abbreviationcharacterHome team abbreviation.
home_display_namecharacterHome team display name.
home_locationcharacterHome team city/location.
home_colorcharacterHome team primary color hex.
home_alternate_colorcharacterHome team alternate color hex.
home_logocharacterHome team logo URL.
home_scorecharacterHome team score.
home_winnerlogicalWhether the home team won.
home_rankintegerHome team rank (if ranked).
away_idcharacterAway team ESPN identifier.
away_namecharacterAway team name.
away_abbreviationcharacterAway team abbreviation.
away_display_namecharacterAway team display name.
away_locationcharacterAway team city/location.
away_colorcharacterAway team primary color hex.
away_alternate_colorcharacterAway team alternate color hex.
away_logocharacterAway team logo URL.
away_scorecharacterAway team score.
away_winnerlogicalWhether the away team won.
away_rankintegerAway team rank (if ranked).

Details

League slug mens-college-hockey; season is the END year (2026 = 2025-26). Same ESPN helper as espn_nhl_scoreboard(); columns verified against a captured MCH body.

espn_wch_scoreboard() 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_scoreboard(dates = "20250110"))
#> ── MENS-COLLEGE-HOCKEY Scoreboard data from ESPN.com ────── fastRhockey 1.1.0 ──
#> ℹ Data updated: 2026-11-13 21:26:29 UTC
#> # A tibble: 29 × 50
#>    game_id   uid      date  name  short_name season_year season_type season_slug
#>    <chr>     <chr>    <chr> <chr> <chr>            <int>       <int> <chr>      
#>  1 401715296 s:70~l:… 2025… Minn… MINN @ OSU        2025           2 regular-se…
#>  2 401711967 s:70~l:… 2025… Alas… UAA @ NIA         2025           2 regular-se…
#>  3 401711856 s:70~l:… 2025… Merc… MERC @ AR…        2025           2 regular-se…
#>  4 401711903 s:70~l:… 2025… RIT … RIT @ CAN         2025           2 regular-se…
#>  5 401712001 s:70~l:… 2025… Robe… RMU @ HC          2025           2 regular-se…
#>  6 401712011 s:70~l:… 2025… Corn… COR @ SHU         2025           2 regular-se…
#>  7 401712030 s:70~l:… 2025… Verm… UVM @ BU          2025           2 regular-se…
#>  8 401712089 s:70~l:… 2025… UCon… CONN @ UNH        2025           2 regular-se…
#>  9 401713283 s:70~l:… 2025… Unio… UNNY @ CL…        2025           2 regular-se…
#> 10 401713340 s:70~l:… 2025… Quin… QUIN @ PR…        2025           2 regular-se…
#> # ℹ 19 more rows
#> # ℹ 42 more variables: status_type_id <chr>, status_type_name <chr>,
#> #   status_type_state <chr>, status_type_completed <lgl>,
#> #   status_type_description <chr>, status_type_detail <chr>,
#> #   status_type_short_detail <chr>, status_clock <dbl>,
#> #   status_display_clock <chr>, status_period <int>, neutral_site <lgl>,
#> #   conference_competition <chr>, attendance <int>, venue_id <chr>, …
# }
# \donttest{
  try(espn_wch_scoreboard(dates = "20250110"))
#> data frame with 0 columns and 0 rows
# }