Skip to contents

Get ESPN MCH / WCH Play-by-Play

Usage

espn_mch_pbp(game_id, ...)

espn_wch_pbp(game_id, ...)

Arguments

game_id

ESPN event identifier (character or numeric).

...

Reserved for forward compatibility.

Value

A fastRhockey_data tibble, one row per play:

col_nametypedescription
idcharacterESPN play identifier.
sequence_numbercharacterPlay sequence number.
type_idcharacterPlay type identifier.
type_textcharacterPlay type display text.
textcharacterPlay description text.
away_scoreintegerAway team score at time of play.
home_scoreintegerHome team score at time of play.
scoring_playlogicalWhether the play resulted in a goal.
score_valueintegerGoal value (1 for regulation/OT goals).
shooting_playlogicalWhether the play was a shot attempt.
wallclockcharacterWall-clock timestamp (ISO 8601).
period_numberintegerPeriod number (1-3 regulation, 4+ OT/SO).
period_display_valuecharacterPeriod display label (e.g. "1st Period").
clock_display_valuecharacterGame clock display string (e.g. "14:32").
team_idcharacterESPN team identifier for the acting team.
coordinate_xnumericX coordinate of play location.
coordinate_ynumericY coordinate of play location.
strength_idcharacterStrength situation identifier.
strength_textcharacterStrength situation text (e.g. "Even Strength").
shot_info_idcharacterShot type identifier.
shot_info_textcharacterShot type text (e.g. "Wrist Shot").
athlete_id_1characterPrimary participant athlete identifier.
athlete_id_2characterSecondary participant athlete identifier.
athlete_id_3characterTertiary participant athlete identifier.
home_team_idcharacterHome team ESPN identifier.
home_team_namecharacterHome team name.
home_team_locationcharacterHome team city/location.
home_team_abbrevcharacterHome team abbreviation.
home_team_display_namecharacterHome team display name.
home_team_colorcharacterHome team primary color hex.
home_team_alternate_colorcharacterHome team alternate color hex.
home_team_logocharacterHome team logo URL.
home_team_scorecharacterHome team final score.
home_team_winnerlogicalWhether the home team won.
away_team_idcharacterAway team ESPN identifier.
away_team_namecharacterAway team name.
away_team_locationcharacterAway team city/location.
away_team_abbrevcharacterAway team abbreviation.
away_team_display_namecharacterAway team display name.
away_team_colorcharacterAway team primary color hex.
away_team_alternate_colorcharacterAway team alternate color hex.
away_team_logocharacterAway team logo URL.
away_team_scorecharacterAway team final score.
away_team_winnerlogicalWhether the away team won.
game_idcharacterESPN event identifier (echoed from arg).
seasonintegerSeason end-year.
season_typeintegerSeason type code.
game_datecharacterGame date-time (ISO 8601).

Details

League slug mens-college-hockey. Parsed from the site-v2 summary payload by the same helper as espn_nhl_pbp(); columns verified against a captured mch summary body.

espn_wch_pbp() 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_pbp(game_id = "401717648"))
#> ── MENS-COLLEGE-HOCKEY Play-by-Play data from ESPN.com ──── fastRhockey 1.1.0 ──
#> ℹ Data updated: 2026-11-13 21:26:20 UTC
#> # A tibble: 12 × 48
#>    id             sequence_number type_id type_text text   away_score home_score
#>    <chr>          <chr>           <chr>   <chr>     <chr>       <int>      <int>
#>  1 40171764804386 1               505     Goal      Even …          0          1
#>  2 40171764804387 2               505     Goal      Even …          1          1
#>  3 40171764804388 1               509     Penalty   Penal…          0          0
#>  4 40171764804389 3               505     Goal      Even …          1          2
#>  5 40171764804390 4               505     Goal      Even …          1          3
#>  6 40171764804391 2               509     Penalty   Penal…          0          0
#>  7 40171764804392 5               505     Goal      Power…          2          3
#>  8 40171764804393 3               509     Penalty   Penal…          0          0
#>  9 40171764804394 4               509     Penalty   Penal…          0          0
#> 10 40171764804395 6               505     Goal      Even …          2          4
#> 11 40171764804396 7               505     Goal      Even …          2          5
#> 12 40171764804397 8               505     Goal      Empty…          2          6
#> # ℹ 41 more variables: scoring_play <lgl>, score_value <int>,
#> #   shooting_play <lgl>, wallclock <chr>, period_number <int>,
#> #   period_display_value <chr>, clock_display_value <chr>, team_id <chr>,
#> #   coordinate_x <dbl>, coordinate_y <dbl>, strength_id <chr>,
#> #   strength_text <chr>, shot_info_id <chr>, shot_info_text <chr>,
#> #   athlete_id_1 <chr>, athlete_id_2 <chr>, athlete_id_3 <chr>,
#> #   home_team_id <chr>, home_team_name <chr>, home_team_location <chr>, …
# }
# \donttest{
  try(espn_wch_pbp(game_id = "401762970"))
#> ── WOMENS-COLLEGE-HOCKEY Play-by-Play data from ESPN.com ── fastRhockey 1.1.0 ──
#> ℹ Data updated: 2026-11-13 21:26:20 UTC
#> # A tibble: 12 × 48
#>    id             sequence_number type_id type_text text   away_score home_score
#>    <chr>          <chr>           <chr>   <chr>     <chr>       <int>      <int>
#>  1 40176297004123 1               509     Penalty   Penal…          0          0
#>  2 40176297004124 1               505     Goal      Power…          1          0
#>  3 40176297004127 2               509     Penalty   Penal…          0          0
#>  4 40176297004131 2               505     Goal      Even …          1          1
#>  5 40176297004134 3               509     Penalty   Penal…          0          0
#>  6 40176297004135 3               505     Goal      Even …          1          2
#>  7 40176297004140 4               509     Penalty   Penal…          0          0
#>  8 40176297004142 5               509     Penalty   Penal…          0          0
#>  9 40176297004143 4               505     Goal      Power…          1          3
#> 10 40176297004145 6               509     Penalty   Penal…          0          0
#> 11 40176297004146 5               505     Goal      Short…          1          4
#> 12 40176297004147 7               509     Penalty   Penal…          0          0
#> # ℹ 41 more variables: scoring_play <lgl>, score_value <int>,
#> #   shooting_play <lgl>, wallclock <chr>, period_number <int>,
#> #   period_display_value <chr>, clock_display_value <chr>, team_id <chr>,
#> #   coordinate_x <dbl>, coordinate_y <dbl>, strength_id <chr>,
#> #   strength_text <chr>, shot_info_id <chr>, shot_info_text <chr>,
#> #   athlete_id_1 <chr>, athlete_id_2 <chr>, athlete_id_3 <chr>,
#> #   home_team_id <chr>, home_team_name <chr>, home_team_location <chr>, …
# }