Skip to contents

Retrieve game linescores for major and minor league games

Usage

mlb_game_linescore(game_pk)

Arguments

game_pk

The unique game_pk identifier for the game

Value

Returns a tibble with the following columns

col_nametypesdescription
game_pknumericUnique game identifier.
home_team_idcharacterHome team MLB ID.
home_team_namecharacterHome team name.
away_team_idcharacterAway team MLB ID.
away_team_namecharacterAway team name.
numintegerInning number.
ordinal_numcharacterInning ordinal label (e.g. 1st).
home_runsintegerHome runs scored in the inning.
home_hitsintegerHome hits in the inning.
home_errorsintegerHome errors in the inning.
home_left_on_baseintegerHome runners left on base in the inning.
away_runsintegerAway runs scored in the inning.
away_hitsintegerAway hits in the inning.
away_errorsintegerAway errors in the inning.
away_left_on_baseintegerAway runners left on base in the inning.
home_team_all_star_statuscharacterHome team all-star status flag.
home_team_linkcharacterMLB Stats API relative home team link.
home_team_seasoncharacterHome team season (YYYY).
home_team_venue_idcharacterHome team venue ID.
home_team_venue_namecharacterHome team venue name.
home_team_venue_linkcharacterMLB Stats API relative home venue link.
home_team_team_codecharacterHome team code.
home_team_file_codecharacterHome team file code.
home_team_abbreviationcharacterHome team abbreviation.
home_team_team_namecharacterHome team nickname.
home_team_location_namecharacterHome team location/city name.
home_team_first_year_of_playcharacterHome franchise first year of play.
home_team_league_idcharacterHome team league ID.
home_team_league_namecharacterHome team league name.
home_team_league_linkcharacterMLB Stats API relative home league link.
home_team_division_idcharacterHome team division ID.
home_team_division_namecharacterHome team division name.
home_team_division_linkcharacterMLB Stats API relative home division link.
home_team_sport_idcharacterHome team sport ID.
home_team_sport_linkcharacterMLB Stats API relative home sport link.
home_team_sport_namecharacterHome team sport name.
home_team_short_namecharacterHome team short name.
home_team_record_games_playedcharacterHome team games played.
home_team_record_wild_card_games_backcharacterHome team games back in the wild card.
home_team_record_league_games_backcharacterHome team games back in the league.
home_team_record_spring_league_games_backcharacterHome team games back in the spring league.
home_team_record_sport_games_backcharacterHome team games back in the sport.
home_team_record_division_games_backcharacterHome team games back in the division.
home_team_record_conference_games_backcharacterHome team games back in the conference.
home_team_record_league_record_winscharacterHome team league-record wins.
home_team_record_league_record_lossescharacterHome team league-record losses.
home_team_record_league_record_tiescharacterHome team league-record ties.
home_team_record_league_record_pctcharacterHome team winning percentage.
home_team_record_division_leadercharacterWhether the home team leads its division.
home_team_record_winscharacterHome team wins.
home_team_record_lossescharacterHome team losses.
home_team_record_winning_percentagecharacterHome team winning percentage.
home_team_franchise_namecharacterHome franchise name.
home_team_club_namecharacterHome club name.
home_team_activecharacterWhether the home team is active.
away_team_all_star_statuscharacterAway team all-star status flag.
away_team_linkcharacterMLB Stats API relative away team link.
away_team_seasoncharacterAway team season (YYYY).
away_team_venue_idcharacterAway team venue ID.
away_team_venue_namecharacterAway team venue name.
away_team_venue_linkcharacterMLB Stats API relative away venue link.
away_team_team_codecharacterAway team code.
away_team_file_codecharacterAway team file code.
away_team_abbreviationcharacterAway team abbreviation.
away_team_team_namecharacterAway team nickname.
away_team_location_namecharacterAway team location/city name.
away_team_first_year_of_playcharacterAway franchise first year of play.
away_team_league_idcharacterAway team league ID.
away_team_league_namecharacterAway team league name.
away_team_league_linkcharacterMLB Stats API relative away league link.
away_team_division_idcharacterAway team division ID.
away_team_division_namecharacterAway team division name.
away_team_division_linkcharacterMLB Stats API relative away division link.
away_team_sport_idcharacterAway team sport ID.
away_team_sport_linkcharacterMLB Stats API relative away sport link.
away_team_sport_namecharacterAway team sport name.
away_team_short_namecharacterAway team short name.
away_team_record_games_playedcharacterAway team games played.
away_team_record_wild_card_games_backcharacterAway team games back in the wild card.
away_team_record_league_games_backcharacterAway team games back in the league.
away_team_record_spring_league_games_backcharacterAway team games back in the spring league.
away_team_record_sport_games_backcharacterAway team games back in the sport.
away_team_record_division_games_backcharacterAway team games back in the division.
away_team_record_conference_games_backcharacterAway team games back in the conference.
away_team_record_league_record_winscharacterAway team league-record wins.
away_team_record_league_record_lossescharacterAway team league-record losses.
away_team_record_league_record_tiescharacterAway team league-record ties.
away_team_record_league_record_pctcharacterAway team winning percentage.
away_team_record_division_leadercharacterWhether the away team leads its division.
away_team_record_winscharacterAway team wins.
away_team_record_lossescharacterAway team losses.
away_team_record_winning_percentagecharacterAway team winning percentage.
away_team_franchise_namecharacterAway franchise name.
away_team_club_namecharacterAway club name.
away_team_activecharacterWhether the away team is active.

Examples

# \donttest{
  try(mlb_game_linescore(game_pk = 566001))
#> ── MLB Game Linescore data from MLB.com ───────────── baseballr 2.0.0 ──
#>  Data updated: 2026-06-12 14:09:32 UTC
#> # A tibble: 9 × 95
#>   game_pk home_team_id home_team_name away_team_id away_team_name    num
#>     <dbl> <chr>        <chr>          <chr>        <chr>           <int>
#> 1  566001 121          New York Mets  113          Cincinnati Reds     1
#> 2  566001 121          New York Mets  113          Cincinnati Reds     2
#> 3  566001 121          New York Mets  113          Cincinnati Reds     3
#> 4  566001 121          New York Mets  113          Cincinnati Reds     4
#> 5  566001 121          New York Mets  113          Cincinnati Reds     5
#> 6  566001 121          New York Mets  113          Cincinnati Reds     6
#> 7  566001 121          New York Mets  113          Cincinnati Reds     7
#> 8  566001 121          New York Mets  113          Cincinnati Reds     8
#> 9  566001 121          New York Mets  113          Cincinnati Reds     9
#> # ℹ 89 more variables: ordinal_num <chr>, home_runs <int>,
#> #   home_hits <int>, home_errors <int>, home_left_on_base <int>,
#> #   away_runs <int>, away_hits <int>, away_errors <int>,
#> #   away_left_on_base <int>, home_team_all_star_status <chr>,
#> #   home_team_link <chr>, home_team_season <chr>,
#> #   home_team_venue_id <chr>, home_team_venue_name <chr>,
#> #   home_team_venue_link <chr>, home_team_team_code <chr>, …
# }