Returns the live game situation for one MLB event: timeouts remaining,
team fouls, fouls to give, bonus state, and a $ref to the last play.
During a live game this reflects current state; after the game ends
the values are frozen.
Value
A single-row tibble with timeouts + fouls for both teams.
| col_name | types | description |
| league | character | League. |
| event_id | character | Unique ESPN event/game identifier. |
| home_timeouts_current | integer | Home timeouts current. |
| home_timeouts_remaining | integer | Home timeouts remaining. |
| away_timeouts_current | integer | Away timeouts current. |
| away_timeouts_remaining | integer | Away timeouts remaining. |
| home_team_fouls | integer | Home team fouls. |
| home_team_fouls_current | integer | Home team fouls current. |
| home_fouls_to_give | integer | Home fouls to give. |
| home_bonus_state | character | Home bonus state. |
| away_team_fouls | integer | Away team fouls. |
| away_team_fouls_current | integer | Away team fouls current. |
| away_fouls_to_give | integer | Away fouls to give. |
| away_bonus_state | character | Away bonus state. |
| last_play_ref | character | Last play ref. |
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(),
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_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()
Examples
# \donttest{
espn_mlb_game_situation(event_id = 401283399)
#> ✖ 2026-06-08 11:07:44.864296: Failed to retrieve ESPN mlb event situation for event_id=401283399
#> ✖ Args: league = "mlb", event_id = 401283399
#> ✖ Error: The API returned an error, HTTP Response Code 404
#> ── ESPN MLB Event Situation ───────────────────────── baseballr 2.0.0 ──
#> ℹ Data updated: 2026-06-08 11:07:44 UTC
#> # A tibble: 0 × 0
# }