Get ESPN MLB Event Play Detail (Single Play) — espn_mlb_game_play • baseballr

Returns the rich detail block for a single MLB play: sequence, period, clock, text, scoring/shooting flags, current home/away score, team $ref, and shot coordinates if applicable. Complements the bulk espn_mlb_pbp() output by exposing the canonical core-v2 play record.

Usage

espn_mlb_game_play(event_id, play_id, ...)

Arguments

event_id: ESPN event identifier.
play_id: ESPN play identifier (visible in pbp() output as play_id or extractable from plays[].$ref).
...: Additional arguments; currently unused.

Value

A single-row tibble.

col_name	types	description
league	character	League.
event_id	character	Unique ESPN event/game identifier.
play_id	character	Play id.
sequence_number	character	Sequence number.
type_id	character	Type id.
type_text	character	Type text.
text	character	Text description.
short_text	character	Short text.
period	integer	Inning number.
clock	character	Clock.
scoring_play	logical	Scoring play.
score_value	numeric	Score value.
away_score	integer	Away team run total.
home_score	integer	Home team run total.
shooting_play	logical	Shooting play.
coordinate_x	numeric	Coordinate x.
coordinate_y	numeric	Coordinate y.
team_ref	character	Team ref.
wallclock	character	Wallclock.

See also

Other ESPN MLB Functions: espn_mlb, espn_mlb_athletes_index(), espn_mlb_award(), espn_mlb_betting(), espn_mlb_calendar(), espn_mlb_coach(), espn_mlb_coach_record(), espn_mlb_coach_season(), espn_mlb_coaches(), espn_mlb_conferences(), espn_mlb_draft(), espn_mlb_draft_athlete_detail(), espn_mlb_draft_athletes(), espn_mlb_draft_pick(), espn_mlb_draft_rounds(), espn_mlb_draft_status(), espn_mlb_franchise(), espn_mlb_franchises(), espn_mlb_freeagents(), espn_mlb_futures(), espn_mlb_game_all(), espn_mlb_game_broadcasts(), espn_mlb_game_endpoints, espn_mlb_game_info(), espn_mlb_game_odds(), espn_mlb_game_official_detail(), espn_mlb_game_officials(), espn_mlb_game_play_personnel(), espn_mlb_game_player_box(), espn_mlb_game_powerindex(), espn_mlb_game_predictor(), espn_mlb_game_probabilities(), espn_mlb_game_probables(), espn_mlb_game_propbets(), espn_mlb_game_rosters(), espn_mlb_game_situation(), espn_mlb_game_team_leaders(), espn_mlb_game_team_linescores(), espn_mlb_game_team_records(), espn_mlb_game_team_roster(), espn_mlb_game_team_roster_entry(), espn_mlb_game_team_score(), espn_mlb_game_team_statistics(), espn_mlb_injuries(), espn_mlb_leaders(), espn_mlb_news(), espn_mlb_pbp(), espn_mlb_player_awards(), espn_mlb_player_box(), espn_mlb_player_career_stats(), espn_mlb_player_contract(), espn_mlb_player_contracts(), espn_mlb_player_endpoints, espn_mlb_player_eventlog(), espn_mlb_player_eventlog_v2(), espn_mlb_player_gamelog(), espn_mlb_player_info(), espn_mlb_player_overview(), espn_mlb_player_seasons(), espn_mlb_player_splits(), espn_mlb_player_statisticslog(), espn_mlb_player_stats(), espn_mlb_player_stats_v3(), espn_mlb_position(), espn_mlb_positions(), espn_mlb_powerindex(), espn_mlb_scoreboard(), espn_mlb_season_awards(), espn_mlb_season_draft(), espn_mlb_season_group(), espn_mlb_season_group_children(), espn_mlb_season_group_teams(), espn_mlb_season_groups(), espn_mlb_season_info(), espn_mlb_season_leaders(), espn_mlb_season_ranking(), espn_mlb_season_rankings(), espn_mlb_season_type(), espn_mlb_season_types(), espn_mlb_season_week(), espn_mlb_season_weeks(), espn_mlb_seasons(), espn_mlb_standings(), espn_mlb_team(), espn_mlb_team_box(), espn_mlb_team_current_roster(), espn_mlb_team_depthchart(), espn_mlb_team_endpoints, espn_mlb_team_injuries(), espn_mlb_team_leaders(), espn_mlb_team_news(), espn_mlb_team_odds_records(), espn_mlb_team_record(), espn_mlb_team_record_detail(), espn_mlb_team_roster(), espn_mlb_team_schedule(), espn_mlb_team_season_profile(), espn_mlb_team_season_roster(), espn_mlb_team_season_statistics(), espn_mlb_team_stats(), espn_mlb_teams(), espn_mlb_tournament(), espn_mlb_tournament_season(), espn_mlb_tournament_seasons(), espn_mlb_tournaments(), espn_mlb_transactions(), espn_mlb_venues(), espn_mlb_week_ranking(), espn_mlb_week_rankings(), espn_mlb_wp()

Author

Saiem Gilani

Examples

# \donttest{
  espn_mlb_game_play(event_id = 401283399, play_id = 4012833994)
#> ✖ 2026-06-08 11:07:42.088511: Failed to retrieve ESPN mlb event play detail for event_id=401283399, play_id=4012833994
#> ✖ Args: league = "mlb", event_id = 401283399, play_id = 4012833994
#> ✖ Error: The API returned an error, HTTP Response Code 404
#> ── ESPN MLB Event Play Detail ─────────────────────── baseballr 2.0.0 ──
#> ℹ Data updated: 2026-06-08 11:07:42 UTC
#> # A tibble: 0 × 0
# }