Skip to contents

Get ESPN MCH / WCH Game Plays (core-v2 Play-by-Play)

Usage

espn_mch_game_plays(event_id, cid = event_id, limit = 1000, ...)

espn_wch_game_plays(event_id, cid = event_id, limit = 1000, ...)

Arguments

event_id

ESPN event (game) identifier. Use espn_mch_scoreboard()$game_id to find valid event ids.

cid

Competition identifier. Defaults to event_id (for MCH the single competition always has the same id as its parent event).

limit

Maximum number of plays to return. Defaults to 1000. A typical MCH game has 200-260 plays.

...

Reserved for forward compatibility.

Value

A fastRhockey_data tibble with one row per play:

col_nametypedescription
event_idcharacterESPN event id (echoed from arg).
cidcharacterCompetition id (echoed from arg).
idcharacterESPN play identifier.
sequence_numberintegerPlay sequence number within the game.
type_idcharacterPlay type id.
type_textcharacterPlay type label (e.g. "Goal", "Shot", "Face Off").
type_abbreviationcharacterPlay type abbreviation.
textcharacterFull play description text.
short_textcharacterShort play description text.
period_numberintegerPeriod number (1-3 regulation, 4+ OT).
period_displaycharacterPeriod display string (e.g. "1st").
clock_valuenumericClock value in seconds.
clock_displaycharacterClock display string (e.g. "19:34").
away_scoreintegerAway team score after this play.
home_scoreintegerHome team score after this play.
scoring_playlogicalWhether this play resulted in a goal.
score_valueintegerPoint value of the scoring play (1 for a goal).
prioritylogicalWhether this is a priority play for display.
shooting_playlogicalWhether this is a shot on goal.
is_penaltylogicalWhether this is a penalty play.
wallclockcharacterWall-clock UTC timestamp of the play.
coordinate_xnumericX coordinate on the ice surface.
coordinate_ynumericY coordinate on the ice surface.
strength_idcharacterStrength situation id (e.g. even strength, PP, SH).
strength_textcharacterStrength situation description.
team_refcharacter$ref URL for the team associated with the play.
play_refcharacter$ref URL for this play object.

Details

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

espn_wch_game_plays() 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({
    sb <- espn_mch_scoreboard(dates = "20250110")
    espn_mch_game_plays(event_id = sb$game_id[1])
  })
#> ! 2026-11-13 21:26:09.786241: No plays returned for event 401715296.
#> data frame with 0 columns and 0 rows
# }
# \donttest{
  try({
    sb <- espn_wch_scoreboard(dates = "20250110")
    espn_wch_game_plays(event_id = sb$game_id[1])
  })
#> ✖ 2026-11-13 21:26:09.835669: 
#> ✖ Args: league = "womens-college-hockey", event_id = NULL, cid = NULL, limit = 1000
#> ✖ Error: The API returned an error
#> data frame with 0 columns and 0 rows
# }