Skip to main content

MLB — MLB Stats API — Other: pbp–award_recipients

mlb_pbp​

GET /api/v1.1/game/{gamePk}/feed/live — live firehose (v1.1).

Endpoint URL: GET https://statsapi.mlb.com/api/v1.1/game/{game_pk}/feed/live

Valid URL: https://statsapi.mlb.com/api/v1.1/game/716390/feed/live

API ParameterPythonPatternRequiredNullableDescription
game_pkgame_pkY
languagelanguageY
timecodetimecodeY
hydratehydrateY
fieldsfieldsY

Returns​

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_mlb_api_list); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_pbp(game_pk=716390)

Last validated n/a.

mlb_boxscore​

GET /api/v1/game/{gamePk}/boxscore — team + player boxscore for one game.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/game/{game_pk}/boxscore

Valid URL: https://statsapi.mlb.com/api/v1/game/716390/boxscore

API ParameterPythonPatternRequiredNullableDescription
game_pkgame_pkYgame_pk path parameter.
timecodetimecodeYtimecode query parameter.
fieldsfieldsYfields query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
team_sidecharacterHome or away indicator.
team_idintegerUnique ESPN team identifier.
team_namecharacterTeam name.
jersey_numbercharacterJersey number worn (often blank for non-uniformed roles).
parent_team_idintegerMLB Stats API identifier for the player's parent (MLB-level) organization, useful for tracking players on optional assignment.
batting_ordercharacterSpot in the batting order (box-score row order).
all_positionscharacterAll fielding positions played by the player during the game, as a list of position codes.
person_idintegerMLB player ID.
person_full_namecharacterPlayer full name.
person_linkcharacterAPI relative link to the person.
person_boxscore_namecharacterName as shown in box scores.
position_codecharacterNumeric scorekeeping position code.
position_namecharacterPosition name.
position_typecharacterPosition category (e.g. 'Pitcher', 'Infielder').
position_abbreviationcharacterPosition abbreviation.
status_codecharacterStatus code identifier (e.g. 'S', 'P', 'I', 'F').
status_descriptioncharacterRoster status description (e.g. 'Active').
stats_batting_summarycharacterCondensed text summary of the batter's performance line (e.g., '2-4, HR, 2 RBI') for display purposes.
stats_batting_games_playeddoubleNumber of games played indicator for this batter's boxscore row (typically 1 for a standard game appearance).
stats_batting_fly_outsdoubleNumber of outs recorded by the batter on fly balls in this game.
stats_batting_ground_outsdoubleNumber of outs recorded by the batter on ground balls in this game.
stats_batting_air_outsdoubleNumber of outs recorded by the batter on balls hit in the air during this game.
stats_batting_runsdoubleNumber of runs scored by the batter in this game.
stats_batting_doublesdoubleNumber of doubles hit by the batter in this game.
stats_batting_triplesdoubleNumber of triples hit by the batter in this game.
stats_batting_home_runsdoubleNumber of home runs hit by the batter in this game.
stats_batting_strike_outsdoubleNumber of times the batter struck out in this game.
stats_batting_base_on_ballsdoubleNumber of walks (bases on balls) drawn by the batter in this game, including intentional walks.
stats_batting_intentional_walksdoubleNumber of intentional walks issued to the batter in this game.
stats_batting_hitsdoubleTotal number of hits recorded by the batter in this game.
stats_batting_hit_by_pitchdoubleNumber of times the batter was hit by a pitch in this game.
stats_batting_at_batsdoubleNumber of official at-bats for the batter in this game.
stats_batting_caught_stealingdoubleNumber of times the batter was caught stealing in this game.
stats_batting_stolen_basesdoubleNumber of stolen bases recorded by the batter in this game.
stats_batting_stolen_base_percentagecharacterPercentage of stolen base attempts that were successful for the batter in this game.
stats_batting_ground_into_double_playdoubleNumber of times the batter grounded into a double play in this game.
stats_batting_ground_into_triple_playdoubleNumber of times the batter grounded into a triple play in this game.
stats_batting_plate_appearancesdoubleTotal number of plate appearances for the batter in this game.
stats_batting_total_basesdoubleTotal number of bases accumulated by the batter on hits in this game.
stats_batting_rbidoubleNumber of runs batted in (RBI) credited to the batter in this game.
stats_batting_left_on_basedoubleNumber of runners left on base when the batter made an out or the inning ended in this game.
stats_batting_sac_buntsdoubleNumber of sacrifice bunts executed by the batter in this game.
stats_batting_sac_fliesdoubleNumber of sacrifice flies hit by the batter that scored a run in this game.
stats_batting_catchers_interferencedoubleNumber of times the batter reached base due to catcher's interference in this game.
stats_batting_pickoffsdoubleNumber of times the batter was picked off base in this game.
stats_batting_at_bats_per_home_runcharacterAt-bats per home run ratio for the batter in this game.
stats_batting_pop_outsdoubleNumber of outs recorded by the batter on infield pop-ups in this game.
stats_batting_line_outsdoubleNumber of outs recorded by the batter on line drives caught in this game.
stats_fielding_caught_stealingdoubleNumber of baserunners caught stealing by the player (typically a catcher) in this game.
stats_fielding_stolen_basesdoubleNumber of stolen bases allowed by the player while fielding in this game.
stats_fielding_stolen_base_percentagecharacterPercentage of stolen base attempts against the player (catcher perspective) that were successful in this game.
stats_fielding_caught_stealing_percentagecharacterPercentage of stolen base attempts that the player threw out in this game.
stats_fielding_assistsdoubleNumber of fielding assists recorded by the player in this game.
stats_fielding_put_outsdoubleNumber of putouts recorded by the player in this game.
stats_fielding_errorsdoubleNumber of fielding errors committed by the player in this game.
stats_fielding_chancesdoubleTotal fielding chances for the player in this game (putouts + assists + errors).
stats_fielding_fieldingcharacterFielding percentage for the player in this game, calculated as (putouts + assists) / total chances.
stats_fielding_passed_balldoubleNumber of passed balls charged to the player (catcher-specific) in this game.
stats_fielding_pickoffsdoubleNumber of pickoffs credited to the player as a fielder in this game.
season_stats_batting_games_playedintegerSeason-to-date number of games in which the batter appeared.
season_stats_batting_fly_outsintegerSeason-to-date number of outs recorded by the batter on fly balls caught in the outfield.
season_stats_batting_ground_outsintegerSeason-to-date number of outs recorded by the batter on ground balls.
season_stats_batting_air_outsintegerSeason-to-date number of outs recorded by the batter on balls hit in the air (fly balls and line drives caught).
season_stats_batting_runsintegerSeason-to-date number of runs scored by the batter.
season_stats_batting_doublesintegerSeason-to-date number of doubles hit by the batter.
season_stats_batting_triplesintegerSeason-to-date number of triples hit by the batter.
season_stats_batting_home_runsintegerSeason-to-date number of home runs hit by the batter.
season_stats_batting_strike_outsintegerSeason-to-date number of times the batter struck out.
season_stats_batting_base_on_ballsintegerSeason-to-date total walks (bases on balls) drawn by the batter, including intentional walks.
season_stats_batting_intentional_walksintegerSeason-to-date number of intentional walks (IBB) issued to the batter.
season_stats_batting_hitsintegerSeason-to-date total number of hits recorded by the batter.
season_stats_batting_hit_by_pitchintegerSeason-to-date number of times the batter was hit by a pitch.
season_stats_batting_avgcharacterSeason-to-date batting average (hits divided by at-bats) for the batter.
season_stats_batting_at_batsintegerSeason-to-date number of official at-bats accumulated by the batter.
season_stats_batting_obpcharacterSeason-to-date on-base percentage (OBP), measuring how often the batter reaches base per plate appearance.
season_stats_batting_slgcharacterSeason-to-date slugging percentage (SLG), measuring total bases per at-bat.
season_stats_batting_opscharacterSeason-to-date on-base plus slugging percentage (OPS), a combined measure of a batter's ability to get on base and hit for power.
season_stats_batting_caught_stealingintegerSeason-to-date number of times the batter was caught stealing a base.
season_stats_batting_stolen_basesintegerSeason-to-date number of bases stolen by the batter.
season_stats_batting_stolen_base_percentagecharacterSeason-to-date percentage of stolen base attempts that were successful for the batter.
season_stats_batting_caught_stealing_percentagecharacterSeason-to-date percentage of stolen base attempts that resulted in the batter being caught stealing.
season_stats_batting_ground_into_double_playintegerSeason-to-date number of times the batter grounded into a double play.
season_stats_batting_ground_into_triple_playintegerSeason-to-date number of times the batter grounded into a triple play.
season_stats_batting_plate_appearancesintegerSeason-to-date total number of plate appearances for the batter, including at-bats, walks, HBP, and sacrifices.
season_stats_batting_total_basesintegerSeason-to-date total number of bases accumulated by the batter on hits.
season_stats_batting_rbiintegerSeason-to-date number of runs batted in (RBI) credited to the batter.
season_stats_batting_left_on_baseintegerSeason-to-date number of runners left on base when the batter made an out or the inning ended.
season_stats_batting_sac_buntsintegerSeason-to-date number of sacrifice bunts executed by the batter.
season_stats_batting_sac_fliesintegerSeason-to-date number of sacrifice flies hit by the batter that scored a run.
season_stats_batting_babipcharacterSeason-to-date Batting Average on Balls In Play (BABIP), measuring batting average excluding strikeouts and home runs.
season_stats_batting_ground_outs_to_airoutscharacterSeason-to-date ratio of ground outs to air outs, indicating the batter's tendency to hit the ball on the ground versus in the air.
season_stats_batting_catchers_interferenceintegerSeason-to-date number of times the batter reached base due to catcher's interference.
season_stats_batting_pickoffsintegerSeason-to-date number of times the batter was picked off base by a pitcher or catcher.
season_stats_batting_at_bats_per_home_runcharacterSeason-to-date ratio of at-bats per home run, reflecting the batter's home run frequency.
season_stats_batting_pop_outsintegerSeason-to-date number of outs recorded by the batter on pop-ups caught in the infield.
season_stats_batting_line_outsintegerSeason-to-date number of outs recorded by the batter on line drives caught.
season_stats_pitching_games_playedintegerSeason-to-date number of games the pitcher was active on the roster (may include non-pitching appearances).
season_stats_pitching_games_startedintegerSeason-to-date number of games in which the pitcher was the starting pitcher.
season_stats_pitching_fly_outsintegerSeason-to-date number of outs recorded by the pitcher on fly balls.
season_stats_pitching_ground_outsintegerSeason-to-date number of outs recorded by the pitcher on ground balls.
season_stats_pitching_air_outsintegerSeason-to-date number of outs recorded by the pitcher on balls hit in the air.
season_stats_pitching_runsintegerSeason-to-date total runs (earned and unearned) allowed by the pitcher.
season_stats_pitching_doublesintegerSeason-to-date number of doubles allowed by the pitcher.
season_stats_pitching_triplesintegerSeason-to-date number of triples allowed by the pitcher.
season_stats_pitching_home_runsintegerSeason-to-date number of home runs allowed by the pitcher.
season_stats_pitching_strike_outsintegerSeason-to-date number of batters struck out by the pitcher.
season_stats_pitching_base_on_ballsintegerSeason-to-date total walks (bases on balls) issued by the pitcher, including intentional walks.
season_stats_pitching_intentional_walksintegerSeason-to-date number of intentional walks (IBB) issued by the pitcher.
season_stats_pitching_hitsintegerSeason-to-date number of hits allowed by the pitcher.
season_stats_pitching_hit_by_pitchintegerSeason-to-date number of hit-by-pitch events while the pitcher was pitching (alternate field name for hit_batsmen).
season_stats_pitching_at_batsintegerSeason-to-date number of at-bats faced by the pitcher (excluding walks, HBP, and sacrifices).
season_stats_pitching_obpcharacterSeason-to-date on-base percentage allowed by the pitcher (opponents' OBP against this pitcher).
season_stats_pitching_caught_stealingintegerSeason-to-date number of baserunners caught stealing while the pitcher was on the mound.
season_stats_pitching_stolen_basesintegerSeason-to-date number of stolen bases allowed while the pitcher was pitching.
season_stats_pitching_stolen_base_percentagecharacterSeason-to-date percentage of stolen base attempts that were successful while the pitcher was on the mound.
season_stats_pitching_caught_stealing_percentagecharacterSeason-to-date percentage of stolen base attempts that were thrown out while the pitcher was pitching.
season_stats_pitching_number_of_pitchesintegerSeason-to-date total number of pitches thrown by the pitcher.
season_stats_pitching_eracharacterSeason-to-date Earned Run Average (ERA) for the pitcher, expressed as earned runs per nine innings.
season_stats_pitching_innings_pitchedcharacterSeason-to-date total innings pitched, expressed as a decimal where each out is one-third of an inning.
season_stats_pitching_winsintegerSeason-to-date number of wins credited to the pitcher.
season_stats_pitching_lossesintegerSeason-to-date number of losses charged to the pitcher.
season_stats_pitching_savesintegerSeason-to-date number of saves recorded by the pitcher.
season_stats_pitching_save_opportunitiesintegerSeason-to-date number of save opportunities the pitcher entered (leads of three runs or fewer in the seventh inning or later, or entering with the tying run on base).
season_stats_pitching_holdsintegerSeason-to-date number of holds recorded by the pitcher (relief appearance maintaining a lead without a save situation).
season_stats_pitching_blown_savesintegerSeason-to-date number of blown save opportunities for the pitcher.
season_stats_pitching_earned_runsintegerSeason-to-date number of earned runs allowed by the pitcher.
season_stats_pitching_whipcharacterSeason-to-date Walks plus Hits per Inning Pitched (WHIP), measuring baserunners allowed per inning.
season_stats_pitching_batters_facedintegerSeason-to-date total number of batters faced by the pitcher.
season_stats_pitching_outsintegerSeason-to-date total number of outs recorded by the pitcher.
season_stats_pitching_games_pitchedintegerSeason-to-date number of games in which the pitcher appeared.
season_stats_pitching_complete_gamesintegerSeason-to-date number of complete games pitched by the pitcher.
season_stats_pitching_shutoutsintegerSeason-to-date number of complete-game shutouts pitched.
season_stats_pitching_ballsintegerSeason-to-date number of ball calls recorded against the pitcher.
season_stats_pitching_strikesintegerSeason-to-date total number of strikes thrown by the pitcher.
season_stats_pitching_strike_percentagecharacterSeason-to-date percentage of all pitches thrown that were strikes.
season_stats_pitching_hit_batsmenintegerSeason-to-date number of batters hit by a pitch thrown by the pitcher.
season_stats_pitching_balksintegerSeason-to-date number of balks called against the pitcher.
season_stats_pitching_wild_pitchesintegerSeason-to-date number of wild pitches thrown by the pitcher.
season_stats_pitching_pickoffsintegerSeason-to-date number of pickoffs executed by the pitcher.
season_stats_pitching_ground_outs_to_airoutscharacterSeason-to-date ratio of ground ball outs to air ball outs allowed by the pitcher.
season_stats_pitching_rbiintegerSeason-to-date number of RBI allowed (runs batted in by opposing batters) while this pitcher was pitching.
season_stats_pitching_win_percentagecharacterSeason-to-date winning percentage for the pitcher (wins divided by decisions).
season_stats_pitching_pitches_per_inningcharacterSeason-to-date average number of pitches thrown per inning by the pitcher.
season_stats_pitching_games_finishedintegerSeason-to-date number of games in which the pitcher was the last pitcher used by their team.
season_stats_pitching_strikeout_walk_ratiocharacterSeason-to-date ratio of strikeouts to walks, measuring the pitcher's command and dominance.
season_stats_pitching_strikeouts_per9_inncharacterSeason-to-date strikeouts recorded per nine innings pitched (K/9), a rate measure of strikeout ability.
season_stats_pitching_walks_per9_inncharacterSeason-to-date walks issued per nine innings pitched (BB/9), a rate measure of control.
season_stats_pitching_hits_per9_inncharacterSeason-to-date hits allowed per nine innings pitched, a rate stat measuring hit prevention.
season_stats_pitching_runs_scored_per9characterSeason-to-date total runs (including unearned) allowed per nine innings pitched.
season_stats_pitching_home_runs_per9characterSeason-to-date home runs allowed per nine innings pitched.
season_stats_pitching_inherited_runnersintegerSeason-to-date number of baserunners already on base when the pitcher entered the game.
season_stats_pitching_inherited_runners_scoredintegerSeason-to-date number of inherited runners who eventually scored while or after the pitcher was pitching.
season_stats_pitching_catchers_interferenceintegerSeason-to-date number of times the pitcher benefited from a catcher's interference call.
season_stats_pitching_sac_buntsintegerSeason-to-date number of sacrifice bunts allowed by the pitcher.
season_stats_pitching_sac_fliesintegerSeason-to-date number of sacrifice flies allowed by the pitcher.
season_stats_pitching_passed_ballintegerSeason-to-date number of passed balls that occurred while the pitcher was pitching.
season_stats_pitching_pop_outsintegerSeason-to-date number of outs recorded by the pitcher on pop-ups caught in the infield.
season_stats_pitching_line_outsintegerSeason-to-date number of outs recorded by the pitcher on line drives caught.
season_stats_fielding_caught_stealingintegerSeason-to-date number of baserunners caught stealing by the player (typically a catcher stat).
season_stats_fielding_stolen_basesintegerSeason-to-date number of stolen bases allowed by the player while fielding (typically catcher).
season_stats_fielding_stolen_base_percentagecharacterSeason-to-date percentage of stolen base attempts against the player that were successful (catcher perspective).
season_stats_fielding_caught_stealing_percentagecharacterSeason-to-date percentage of stolen base attempts that the player (usually a catcher) threw out.
season_stats_fielding_assistsintegerSeason-to-date number of fielding assists recorded by the player (touching the ball before a putout by a teammate).
season_stats_fielding_put_outsintegerSeason-to-date number of putouts recorded by the player (directly retiring a baserunner or batter).
season_stats_fielding_errorsintegerSeason-to-date number of fielding errors committed by the player.
season_stats_fielding_chancesintegerSeason-to-date total fielding chances for the player (putouts + assists + errors).
season_stats_fielding_fieldingcharacterSeason-to-date fielding percentage for the player, calculated as (putouts + assists) / total chances.
season_stats_fielding_passed_ballintegerSeason-to-date number of passed balls charged to the player (catcher-specific).
season_stats_fielding_pickoffsintegerSeason-to-date number of pickoffs credited to the player as a fielder.
game_status_is_current_batterlogicalIndicates whether the player is currently at bat at the moment the boxscore was captured.
game_status_is_current_pitcherlogicalIndicates whether the player is currently pitching at the moment the boxscore was captured.
game_status_is_on_benchlogicalIndicates whether the player is currently on the bench (not in the active lineup) at time of capture.
game_status_is_substitutelogicalIndicates whether the player entered the game as a substitute for another player.
stats_fielding_games_starteddoubleIndicator of whether the player started at a fielding position in this game.
season_stats_fielding_games_starteddoubleSeason-to-date number of games in which the player started at a fielding position.
season_stats_pitching_pitches_throwndoubleSeason-to-date total pitches thrown by the pitcher (may differ from number_of_pitches if strikes/balls are tracked separately).
stats_pitching_summarycharacterCondensed text summary of the pitcher's performance line (e.g., '6.0 IP, 2 ER, 8 K') for display purposes.
stats_pitching_games_playeddoubleNumber of games the pitcher appeared in for this boxscore row (typically 1).
stats_pitching_games_starteddoubleIndicator of whether the pitcher was the starting pitcher in this game.
stats_pitching_fly_outsdoubleNumber of outs recorded by the pitcher on fly balls in this game.
stats_pitching_ground_outsdoubleNumber of outs recorded by the pitcher on ground balls in this game.
stats_pitching_air_outsdoubleNumber of outs recorded by the pitcher on balls hit in the air in this game.
stats_pitching_runsdoubleTotal runs (earned and unearned) allowed by the pitcher in this game.
stats_pitching_doublesdoubleNumber of doubles allowed by the pitcher in this game.
stats_pitching_triplesdoubleNumber of triples allowed by the pitcher in this game.
stats_pitching_home_runsdoubleNumber of home runs allowed by the pitcher in this game.
stats_pitching_strike_outsdoubleNumber of batters struck out by the pitcher in this game.
stats_pitching_base_on_ballsdoubleNumber of walks (bases on balls) issued by the pitcher in this game, including intentional walks.
stats_pitching_intentional_walksdoubleNumber of intentional walks (IBB) issued by the pitcher in this game.
stats_pitching_hitsdoubleNumber of hits allowed by the pitcher in this game.
stats_pitching_hit_by_pitchdoubleNumber of hit-by-pitch events while the pitcher was pitching in this game (alternate field for hit_batsmen).
stats_pitching_at_batsdoubleNumber of at-bats faced by the pitcher (excluding walks, HBP, and sacrifices) in this game.
stats_pitching_caught_stealingdoubleNumber of baserunners caught stealing while the pitcher was on the mound in this game.
stats_pitching_stolen_basesdoubleNumber of stolen bases allowed while the pitcher was pitching in this game.
stats_pitching_stolen_base_percentagecharacterPercentage of stolen base attempts that were successful while the pitcher was on the mound in this game.
stats_pitching_number_of_pitchesdoubleTotal number of pitches thrown by the pitcher in this game.
stats_pitching_innings_pitchedcharacterTotal innings pitched by the pitcher in this game, expressed as a decimal (each out counts as one-third of an inning).
stats_pitching_winsdoubleIndicator of whether the pitcher was credited with the win in this game.
stats_pitching_lossesdoubleIndicator of whether the pitcher was charged with the loss in this game.
stats_pitching_savesdoubleIndicator of whether the pitcher recorded a save in this game.
stats_pitching_save_opportunitiesdoubleNumber of save opportunities the pitcher entered in this game.
stats_pitching_holdsdoubleNumber of holds recorded by the pitcher in this game.
stats_pitching_blown_savesdoubleNumber of blown save opportunities for the pitcher in this game.
stats_pitching_earned_runsdoubleNumber of earned runs allowed by the pitcher in this game.
stats_pitching_batters_faceddoubleTotal number of batters faced by the pitcher in this game.
stats_pitching_outsdoubleTotal number of outs recorded by the pitcher in this game.
stats_pitching_games_pitcheddoubleNumber of pitching appearances for the pitcher in this game (typically 1).
stats_pitching_complete_gamesdoubleIndicator of whether the pitcher threw a complete game in this appearance.
stats_pitching_shutoutsdoubleIndicator of whether the pitcher recorded a complete-game shutout in this game.
stats_pitching_pitches_throwndoubleTotal pitches thrown by the pitcher in this game (may differ from number_of_pitches depending on tracking method).
stats_pitching_ballsdoubleNumber of ball calls recorded against the pitcher in this game.
stats_pitching_strikesdoubleTotal number of strikes thrown by the pitcher in this game.
stats_pitching_strike_percentagecharacterPercentage of all pitches thrown that were strikes in this game.
stats_pitching_hit_batsmendoubleNumber of batters hit by a pitch thrown by the pitcher in this game.
stats_pitching_balksdoubleNumber of balks called against the pitcher in this game.
stats_pitching_wild_pitchesdoubleNumber of wild pitches thrown by the pitcher in this game.
stats_pitching_pickoffsdoubleNumber of pickoffs executed by the pitcher in this game.
stats_pitching_rbidoubleNumber of RBI allowed (runs batted in by opposing batters off this pitcher) in this game.
stats_pitching_games_finisheddoubleIndicator of whether the pitcher was the last pitcher used by their team in this game.
stats_pitching_runs_scored_per9characterTotal runs (including unearned) allowed per nine innings rate for the pitcher in this game.
stats_pitching_home_runs_per9characterHome runs allowed per nine innings rate for the pitcher in this game.
stats_pitching_inherited_runnersdoubleNumber of baserunners already on base when the pitcher entered the game.
stats_pitching_inherited_runners_scoreddoubleNumber of inherited runners who scored while or after the pitcher was pitching in this game.
stats_pitching_catchers_interferencedoubleNumber of catcher's interference calls that occurred while the pitcher was pitching in this game.
stats_pitching_sac_buntsdoubleNumber of sacrifice bunts allowed by the pitcher in this game.
stats_pitching_sac_fliesdoubleNumber of sacrifice flies allowed by the pitcher in this game.
stats_pitching_passed_balldoubleNumber of passed balls that occurred while the pitcher was pitching in this game.
stats_pitching_pop_outsdoubleNumber of outs recorded by the pitcher on infield pop-ups in this game.
stats_pitching_line_outsdoubleNumber of outs recorded by the pitcher on line drives caught in this game.
stats_pitching_notecharacterSupplementary note or annotation attached to the pitcher's boxscore line (e.g., indicating a special circumstance).
stats_batting_notecharacterSupplementary note or annotation attached to the batter's boxscore line (e.g., indicating a special circumstance).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_boxscore(game_pk=716390)

Last validated n/a.

mlb_linescore​

GET /api/v1/game/{gamePk}/linescore — inning-by-inning + current game state.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/game/{game_pk}/linescore

Valid URL: https://statsapi.mlb.com/api/v1/game/716390/linescore

API ParameterPythonPatternRequiredNullableDescription
game_pkgame_pkYgame_pk path parameter.
timecodetimecodeYtimecode query parameter.
fieldsfieldsYfields query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
numintegerInning number.
ordinal_numcharacterInning ordinal label (e.g. 1st).
home_runsintegerHome runs.
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.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_linescore(game_pk=716390)

Last validated n/a.

mlb_win_probability​

GET /api/v1/game/{gamePk}/winProbability — per-play WP timeline.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/game/{game_pk}/winProbability

Valid URL: https://statsapi.mlb.com/api/v1/game/716390/winProbability

API ParameterPythonPatternRequiredNullableDescription
game_pkgame_pkYgame_pk path parameter.
fieldsfieldsYfields query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
pitch_indexcharacterA serialized list of indices identifying individual pitch events within the at-bat for this win-probability row.
action_indexcharacterA serialized list of indices identifying action-type events (stolen bases, pickoffs, etc.) within the at-bat for this win-probability row.
runner_indexcharacterA serialized list of indices identifying baserunner movement events during the play in this win-probability row.
runnerscharacterA serialized representation of baserunner movement records for this play in the win-probability feed, capturing start/end base positions and event types.
play_eventscharacterA serialized representation of the sequence of pitch and action events comprising the at-bat for this win-probability row.
creditscharacterA serialized list of player credit records for this play, linking fielding, pitching, or batting achievements to specific player identifiers.
flagscharacterA serialized representation of situational boolean flags associated with this play (e.g., whether it was a big lead situation or a save opportunity).
home_team_win_probabilitydoubleHome team win probability (percent) entering the at-bat.
away_team_win_probabilitydoubleAway team win probability (percent) entering the at-bat.
home_team_win_probability_addeddoubleChange in home team win probability attributed to the at-bat.
play_end_timecharacterThe ISO 8601 timestamp marking the conclusion of the play associated with this win-probability snapshot.
at_bat_indexintegerZero-based index of the at-bat within the game.
result_typecharacterThe high-level category of the play result in the win-probability feed (e.g., 'atBat', 'action').
result_eventcharacterThe short categorical label for the play outcome in the win-probability feed (e.g., 'Single', 'Home Run', 'Strikeout').
result_event_typecharacterThe snake-cased type identifier for the play outcome in the win-probability feed (e.g., 'single', 'home_run').
result_descriptioncharacterA human-readable text description of the play result as reported in the win-probability game feed.
result_rbiintegerThe number of runs batted in credited to the batter for the play in this win-probability row.
result_away_scoreintegerThe away team's cumulative run total at the conclusion of the play in this win-probability row.
result_home_scoreintegerThe home team's cumulative run total at the conclusion of the play in this win-probability row.
result_is_outlogicalBoolean flag indicating whether the batter was retired on the play recorded in this win-probability row.
about_at_bat_indexintegerThe sequential index of the at-bat within the game to which this win-probability observation belongs.
about_half_inningcharacterIndicates whether the win-probability observation occurred in the top or bottom half of the inning.
about_is_top_inninglogicalBoolean flag indicating whether this win-probability observation occurred in the top half of the inning.
about_inningintegerThe inning number in which this win-probability observation was recorded.
about_start_timecharacterThe ISO 8601 timestamp marking the start of the play event within the win-probability game feed.
about_end_timecharacterThe ISO 8601 timestamp marking the end of the play event within the win-probability game feed.
about_is_completelogicalBoolean flag indicating whether the at-bat associated with this win-probability row has concluded.
about_is_scoring_playlogicalBoolean flag indicating whether this play resulted in one or more runs being scored.
about_has_reviewlogicalBoolean flag indicating whether this play was subject to a manager's challenge or umpire review.
about_has_outlogicalBoolean flag indicating whether this play resulted in at least one out being recorded.
about_captivating_indexintegerA numeric score reflecting how compelling or exciting this plate appearance was, based on leverage and game-state context.
count_ballsintegerThe ball count in the current at-bat at the time this win-probability snapshot was recorded.
count_strikesintegerThe strike count in the current at-bat at the time this win-probability snapshot was recorded.
count_outsintegerThe number of outs in the current half-inning at the time this win-probability snapshot was recorded.
matchup_batter_idintegerThe MLB Stats API (MLBAM) numeric identifier for the batter in this win-probability matchup row.
matchup_batter_full_namecharacterThe full name of the batter whose plate appearance generated this win-probability observation.
matchup_batter_linkcharacterThe MLB Stats API relative URL linking to the batter's player resource for this win-probability row.
matchup_bat_side_codecharacterA single-character code indicating the batter's handedness for this matchup in the win-probability feed (e.g., 'L', 'R', 'S').
matchup_bat_side_descriptioncharacterThe human-readable description of the batter's hitting side for this win-probability matchup row.
matchup_pitcher_idintegerThe MLB Stats API (MLBAM) numeric identifier for the pitcher in this win-probability matchup row.
matchup_pitcher_full_namecharacterThe full name of the pitcher who delivered pitches for this win-probability observation.
matchup_pitcher_linkcharacterThe MLB Stats API relative URL linking to the pitcher's player resource for this win-probability row.
matchup_pitch_hand_codecharacterA single-character code indicating the pitcher's throwing hand for this win-probability matchup (e.g., 'L' or 'R').
matchup_pitch_hand_descriptioncharacterThe human-readable description of the pitcher's throwing arm for this win-probability matchup row.
matchup_post_on_first_iddoubleThe MLB Stats API (MLBAM) numeric identifier for the runner on first base after the play in this win-probability row.
matchup_post_on_first_full_namecharacterThe full name of the runner occupying first base at the conclusion of the play in this win-probability row.
matchup_post_on_first_linkcharacterThe MLB Stats API relative URL linking to the player resource of the runner on first base after the play.
matchup_batter_hot_cold_zonescharacterA serialized representation of the batter's hot and cold zone data applicable to this win-probability matchup.
matchup_pitcher_hot_cold_zonescharacterA serialized representation of the pitcher's hot and cold zone data applicable to this win-probability matchup.
matchup_splits_battercharacterA string describing the batter's situational split for this win-probability matchup (e.g., 'vs. Right').
matchup_splits_pitchercharacterA string describing the pitcher's situational split for this win-probability matchup (e.g., 'vs. Left').
matchup_splits_men_on_basecharacterA string describing the baserunner configuration applicable to the batter's situational split in this win-probability row.
leverage_indexdoubleLeverage index quantifying the importance of the at-bat situation.
drama_indexdoubleA numeric score quantifying the dramatic significance of this play within the game, based on win-probability swing and game leverage.
matchup_post_on_second_iddoubleThe MLB Stats API (MLBAM) numeric identifier for the runner on second base after the play in this win-probability row.
matchup_post_on_second_full_namecharacterThe full name of the runner occupying second base at the conclusion of the play in this win-probability row.
matchup_post_on_second_linkcharacterThe MLB Stats API relative URL linking to the player resource of the runner on second base after the play.
matchup_post_on_third_iddoubleThe MLB Stats API (MLBAM) numeric identifier for the runner on third base after the play in this win-probability row.
matchup_post_on_third_full_namecharacterThe full name of the runner occupying third base at the conclusion of the play in this win-probability row.
matchup_post_on_third_linkcharacterThe MLB Stats API relative URL linking to the player resource of the runner on third base after the play.
review_details_is_overturnedlogicalBoolean flag indicating whether the original on-field ruling was reversed following the replay review for this play.
review_details_in_progresslogicalBoolean flag indicating whether a replay review of this play was still underway at the time of data capture.
review_details_review_typecharacterThe type of review mechanism applied to this play in the win-probability feed (e.g., 'managerChallenge', 'umpireReview').
review_details_challenge_team_iddoubleThe MLB Stats API numeric identifier for the team that initiated a replay challenge on this win-probability play.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_win_probability(game_pk=716390)

Last validated n/a.

mlb_people​

GET /api/v1/people?personIds=... — bulk person lookup by MLBAM id.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/people

Valid URL: https://statsapi.mlb.com/api/v1/people

API ParameterPythonPatternRequiredNullableDescription
personIdsperson_idsYpersonIds query parameter.
hydratehydrateYhydrate query parameter.
fieldsfieldsYfields query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idintegerId.
full_namecharacterPlayer's full name.
linkcharacterAPI link to the game feed.
first_namecharacterPlayer first name.
last_namecharacterPlayer last name.
primary_numbercharacterPlayer uniform number.
birth_datecharacterDate of birth (YYYY-MM-DD).
current_ageintegerCurrent age in years.
birth_citycharacterCity of birth.
birth_countrycharacterCountry of birth.
heightcharacterHeight (feet and inches).
weightintegerWeight in pounds.
activelogicalWhether the player is currently active.
use_namecharacterPreferred first name.
use_last_namecharacterPreferred last name.
boxscore_namecharacterName as shown in box scores.
nick_namecharacterPlayer nickname.
gendercharacterPlayer gender.
is_playerlogicalWhether the person is a player.
is_verifiedlogicalWhether the player profile is verified.
pronunciationcharacterPhonetic name pronunciation.
mlb_debut_datecharacterMLB debut date (YYYY-MM-DD).
name_first_lastcharacterName in first-last order.
name_slugcharacterURL-friendly name slug.
first_last_namecharacterFirst and last name.
last_first_namecharacterName in last, first order.
last_init_namecharacterLast name with first initial.
init_last_namecharacterFirst initial with last name.
full_fml_namecharacterFull name (first-middle-last).
full_lfm_namecharacterFull name (last-first-middle).
strike_zone_topdoubleTop of the player's strike zone (feet).
strike_zone_bottomdoubleBottom of the player's strike zone (feet).
primary_position_codecharacterPrimary position code.
primary_position_namecharacterPrimary fielding position name.
primary_position_typecharacterPrimary position type (e.g. Infielder).
primary_position_abbreviationcharacterPrimary position abbreviation.
bat_side_codecharacterBatting side code (L/R/S).
bat_side_descriptioncharacterBatting side description.
pitch_hand_codecharacterThrowing hand code (L/R).
pitch_hand_descriptioncharacterThrowing hand description.
birth_state_provincecharacterState or province of birth.
middle_namecharacterPlayer middle name.
draft_yeardoubleYear the player was drafted.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_people()

Last validated n/a.

mlb_person​

GET /api/v1/people/{personId} — single person detail.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/people/{person_id}

Valid URL: https://statsapi.mlb.com/api/v1/people/660271

API ParameterPythonPatternRequiredNullableDescription
person_idperson_idYperson_id path parameter.
seasonseasonYSeason year (e.g. 2024).
hydratehydrateYhydrate query parameter.
fieldsfieldsYfields query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idintegerId.
full_namecharacterPlayer's full name.
linkcharacterAPI link to the game feed.
first_namecharacterPlayer first name.
last_namecharacterPlayer last name.
primary_numbercharacterPlayer uniform number.
birth_datecharacterDate of birth (YYYY-MM-DD).
current_ageintegerCurrent age in years.
birth_citycharacterCity of birth.
birth_countrycharacterCountry of birth.
heightcharacterHeight (feet and inches).
weightintegerWeight in pounds.
activelogicalWhether the player is currently active.
use_namecharacterPreferred first name.
use_last_namecharacterPreferred last name.
boxscore_namecharacterName as shown in box scores.
nick_namecharacterPlayer nickname.
gendercharacterPlayer gender.
is_playerlogicalWhether the person is a player.
is_verifiedlogicalWhether the player profile is verified.
pronunciationcharacterPhonetic name pronunciation.
mlb_debut_datecharacterMLB debut date (YYYY-MM-DD).
name_first_lastcharacterName in first-last order.
name_slugcharacterURL-friendly name slug.
first_last_namecharacterFirst and last name.
last_first_namecharacterName in last, first order.
last_init_namecharacterLast name with first initial.
init_last_namecharacterFirst initial with last name.
full_fml_namecharacterFull name (first-middle-last).
full_lfm_namecharacterFull name (last-first-middle).
strike_zone_topdoubleTop of the player's strike zone (feet).
strike_zone_bottomdoubleBottom of the player's strike zone (feet).
primary_position_codecharacterPrimary position code.
primary_position_namecharacterPrimary fielding position name.
primary_position_typecharacterPrimary position type (e.g. Infielder).
primary_position_abbreviationcharacterPrimary position abbreviation.
bat_side_codecharacterBatting side code (L/R/S).
bat_side_descriptioncharacterBatting side description.
pitch_hand_codecharacterThrowing hand code (L/R).
pitch_hand_descriptioncharacterThrowing hand description.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_person(person_id=660271)

Last validated n/a.

mlb_person_game_stats​

GET /api/v1/people/{personId}/stats/game/{gamePk} — one player, one game.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/people/{person_id}/stats/game/{game_pk}

Valid URL: https://statsapi.mlb.com/api/v1/people/660271/stats/game/716390

API ParameterPythonPatternRequiredNullableDescription
person_idperson_idYperson_id path parameter.
game_pkgame_pkYgame_pk path parameter.
fieldsfieldsYfields query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
total_splitsdoubleTotal number of splits in the leaderboard.
exemptionscharacterSerialized list of statistical exemptions or special-case flags applied to this player's game-log splits.
splitscharacterSplits.
type_display_namecharacterStat type display name.
group_display_namecharacterStat group display name.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_person_game_stats(person_id=660271, game_pk=716390)

Last validated n/a.

mlb_sport_players​

GET /api/v1/sports/{sportId}/players — every player in a sport for a season.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/sports/{sport_id}/players

Valid URL: https://statsapi.mlb.com/api/v1/sports

API ParameterPythonPatternRequiredNullableDescription
sport_idsport_idYsport_id path parameter.
seasonseasonYSeason year (e.g. 2024).
hydratehydrateYhydrate query parameter.
fieldsfieldsYfields query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idintegerId.
full_namecharacterPlayer's full name.
linkcharacterAPI link to the game feed.
first_namecharacterPlayer first name.
last_namecharacterPlayer last name.
primary_numbercharacterPlayer uniform number.
birth_datecharacterDate of birth (YYYY-MM-DD).
current_ageintegerCurrent age in years.
birth_citycharacterCity of birth.
birth_state_provincecharacterState or province of birth.
birth_countrycharacterCountry of birth.
heightcharacterHeight (feet and inches).
weightintegerWeight in pounds.
activelogicalWhether the player is currently active.
use_namecharacterPreferred first name.
use_last_namecharacterPreferred last name.
middle_namecharacterPlayer middle name.
boxscore_namecharacterName as shown in box scores.
gendercharacterPlayer gender.
is_playerlogicalWhether the person is a player.
is_verifiedlogicalWhether the player profile is verified.
draft_yeardoubleYear the player was drafted.
mlb_debut_datecharacterMLB debut date (YYYY-MM-DD).
name_first_lastcharacterName in first-last order.
name_slugcharacterURL-friendly name slug.
first_last_namecharacterFirst and last name.
last_first_namecharacterName in last, first order.
last_init_namecharacterLast name with first initial.
init_last_namecharacterFirst initial with last name.
full_fml_namecharacterFull name (first-middle-last).
full_lfm_namecharacterFull name (last-first-middle).
strike_zone_topdoubleTop of the player's strike zone (feet).
strike_zone_bottomdoubleBottom of the player's strike zone (feet).
current_team_idintegerCurrent team MLBAM ID.
current_team_namecharacterCurrent team name.
current_team_linkcharacterAPI link to the current team.
primary_position_codecharacterPrimary position code.
primary_position_namecharacterPrimary fielding position name.
primary_position_typecharacterPrimary position type (e.g. Infielder).
primary_position_abbreviationcharacterPrimary position abbreviation.
bat_side_codecharacterBatting side code (L/R/S).
bat_side_descriptioncharacterBatting side description.
pitch_hand_codecharacterThrowing hand code (L/R).
pitch_hand_descriptioncharacterThrowing hand description.
name_matrilinealcharacterMaternal family name.
nick_namecharacterPlayer nickname.
pronunciationcharacterPhonetic name pronunciation.
last_played_datecharacterDate of last MLB game played.
name_titlecharacterName title.
name_suffixcharacterName suffix (e.g. Jr., Sr., III).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_sport_players()

Last validated n/a.

mlb_sports​

GET /api/v1/sports — list known sports (MLB, MiLB, KBO, NPB, …).

Endpoint URL: GET https://statsapi.mlb.com/api/v1/sports

Valid URL: https://statsapi.mlb.com/api/v1/sports

API ParameterPythonPatternRequiredNullableDescription
sportIdsport_idYsportId query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idintegerId.
codecharacterFielder detail type code.
linkcharacterAPI link to the game feed.
namecharacterDisplay name.
abbreviationcharacterShort abbreviation.
sort_orderintegerDisplay sort order for the sport.
active_statuslogicalWhether the sport/level is active.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_sports()

Last validated n/a.

mlb_leagues​

GET /api/v1/leagues — list leagues.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/leagues

Valid URL: https://statsapi.mlb.com/api/v1/leagues

API ParameterPythonPatternRequiredNullableDescription
sportIdsport_idYsportId query parameter.
seasonseasonYSeason year (e.g. 2024).
leagueIdsleague_idsYleagueIds query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idintegerId.
namecharacterDisplay name.
linkcharacterAPI link to the game feed.
abbreviationcharacterShort abbreviation.
name_shortcharacterShort name of player (First Initial, Last Name)
season_statecharacterA string describing the current phase of the league's season (e.g., 'inProgress', 'offseason', 'preseason').
has_wild_cardlogicalBoolean flag indicating whether this league includes a wild card playoff format for postseason eligibility.
has_split_seasonlogicalBoolean flag indicating whether this league divides its season into two halves with separate standings (as used historically in some minor leagues).
num_gamesdoubleThe total number of regular-season games scheduled per team in this league for the given season.
has_playoff_pointslogicalBoolean flag indicating whether this league uses a playoff points system to determine postseason seeding.
num_teamsdoubleNumber of teams the player appeared for.
num_wildcard_teamsdoubleThe number of wild card berths available for postseason entry in this league for the given season.
seasoncharacterSeason year.
org_codecharacterThe organizational code identifying the parent body (e.g., 'MLB') governing this league within the MLB Stats API hierarchy.
conferences_in_uselogicalWhether conferences were in use that season.
divisions_in_uselogicalWhether divisions were in use that season.
sort_orderintegerDisplay sort order for the sport.
activelogicalWhether the player is currently active.
season_date_info_season_idcharacterSeason identifier for the date info block.
season_date_info_pre_season_start_datecharacterPreseason start date (YYYY-MM-DD).
season_date_info_pre_season_end_datecharacterPreseason end date (YYYY-MM-DD).
season_date_info_season_start_datecharacterSeason start date (YYYY-MM-DD).
season_date_info_spring_start_datecharacterSpring training start date (YYYY-MM-DD).
season_date_info_spring_end_datecharacterSpring training end date (YYYY-MM-DD).
season_date_info_regular_season_start_datecharacterRegular season start date (YYYY-MM-DD).
season_date_info_last_date1st_halfcharacterLast date of the first half (YYYY-MM-DD).
season_date_info_all_star_datecharacterAll-Star Game date (YYYY-MM-DD).
season_date_info_first_date2nd_halfcharacterFirst date of the second half (YYYY-MM-DD).
season_date_info_regular_season_end_datecharacterRegular season end date (YYYY-MM-DD).
season_date_info_post_season_start_datecharacterPostseason start date (YYYY-MM-DD).
season_date_info_post_season_end_datecharacterPostseason end date (YYYY-MM-DD).
season_date_info_season_end_datecharacterSeason end date (YYYY-MM-DD).
season_date_info_offseason_start_datecharacterOffseason start date (YYYY-MM-DD).
season_date_info_off_season_end_datecharacterOffseason end date (YYYY-MM-DD).
season_date_info_season_level_gameday_typecharacterSeason-level Gameday data type code.
season_date_info_game_level_gameday_typecharacterGame-level Gameday data type code.
season_date_info_qualifier_plate_appearancesdoublePlate appearances per game needed to qualify.
season_date_info_qualifier_outs_pitcheddoubleOuts pitched per game needed to qualify.
sport_iddoubleSport MLBAM ID.
sport_linkcharacterAPI link to the sport.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_leagues()

Last validated n/a.

mlb_season​

GET /api/v1/seasons/{seasonId} — single season detail.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/seasons/{season_id}

Valid URL: https://statsapi.mlb.com/api/v1/seasons/X

API ParameterPythonPatternRequiredNullableDescription
season_idseason_idYseason_id path parameter.
sportIdsport_idYsportId query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
season_idcharacterstats.ncaa.org season identifier.
has_wildcardlogicalWhether the season has a wild card round.
pre_season_start_datecharacterPre-season start date.
pre_season_end_datecharacterPre-season end date.
season_start_datecharacterSeason start date.
spring_start_datecharacterSpring training start date.
spring_end_datecharacterSpring training end date.
regular_season_start_datecharacterRegular season start date.
last_date1st_halfcharacterLast date of the first half.
all_star_datecharacterAll-Star Game date.
first_date2nd_halfcharacterFirst date of the second half.
regular_season_end_datecharacterRegular season end date.
post_season_start_datecharacterPost-season start date.
post_season_end_datecharacterPost-season end date.
season_end_datecharacterSeason end date.
offseason_start_datecharacterOff-season start date.
off_season_end_datecharacterOff-season end date.
season_level_gameday_typecharacterSeason-level Gameday data feed type.
game_level_gameday_typecharacterGame-level Gameday data feed type.
qualifier_plate_appearancesdoublePlate appearances per team game to qualify.
qualifier_outs_pitcheddoubleOuts pitched per team game to qualify.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_season(season_id='X')

Last validated n/a.

mlb_venues​

GET /api/v1/venues — list venues.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/venues

Valid URL: https://statsapi.mlb.com/api/v1/venues

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason year (e.g. 2024).
sportIdssport_idsYsportIds query parameter.
hydratehydrateYhydrate query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idintegerId.
namecharacterDisplay name.
linkcharacterAPI link to the game feed.
activelogicalWhether the player is currently active.
seasoncharacterSeason year.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_venues()

Last validated n/a.

mlb_venue​

GET /api/v1/venues/{venueId} — single venue detail.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/venues/{venue_id}

Valid URL: https://statsapi.mlb.com/api/v1/venues/15

API ParameterPythonPatternRequiredNullableDescription
venue_idvenue_idYvenue_id path parameter.
seasonseasonYSeason year (e.g. 2024).
hydratehydrateYhydrate query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idintegerId.
namecharacterDisplay name.
linkcharacterAPI link to the game feed.
activelogicalWhether the player is currently active.
seasoncharacterSeason year.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_venue(venue_id=15)

Last validated n/a.

mlb_meta​

GET /api/v1/{metaType} — enum lookup (the API's self-describing surface).

Endpoint URL: GET https://statsapi.mlb.com/api/v1/{meta_type}

Valid URL: https://statsapi.mlb.com/api/v1/leagueLeaderTypes

API ParameterPythonPatternRequiredNullableDescription
meta_typemeta_typeYmeta_type path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_mlb_api_list); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_meta(meta_type='leagueLeaderTypes')

Last validated n/a.

mlb_awards​

GET /api/v1/awards — list award IDs (call with no params to enumerate).

Endpoint URL: GET https://statsapi.mlb.com/api/v1/awards

Valid URL: https://statsapi.mlb.com/api/v1/awards

API ParameterPythonPatternRequiredNullableDescription
sportIdsport_idYsportId query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idcharacterId.
namecharacterDisplay name.
descriptioncharacterLong-form description text.
sort_orderdoubleDisplay sort order for the sport.
activelogicalWhether the player is currently active.
sport_iddoubleSport MLBAM ID.
sport_linkcharacterAPI link to the sport.
league_iddoubleLeague MLBAM ID.
league_linkcharacterAPI link to the league.
notescharacterNotes.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_awards()

Last validated n/a.

mlb_award_recipients​

GET /api/v1/awards/{awardId}/recipients — historical winners of one award.

Endpoint URL: GET https://statsapi.mlb.com/api/v1/awards/{award_id}/recipients

Valid URL: https://statsapi.mlb.com/api/v1/awards/MLBHOF/recipients

API ParameterPythonPatternRequiredNullableDescription
award_idaward_idYaward_id path parameter.
seasonseasonYSeason year (e.g. 2024).
sportIdsport_idYsportId query parameter.
hydratehydrateYhydrate query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idcharacterId.
namecharacterDisplay name.
datecharacterDate in YYYY-MM-DD format.
seasoncharacterSeason year.
team_idintegerUnique ESPN team identifier.
team_linkcharacterAPI link to the team.
player_idintegerstats.ncaa.org player identifier.
player_linkcharacterAPI relative link to the player.
player_primary_position_codecharacterRecipient primary fielding position code.
player_primary_position_namecharacterRecipient primary fielding position name.
player_primary_position_typecharacterParticipant primary position type (e.g. 'Hitter').
player_primary_position_abbreviationcharacterParticipant primary position abbreviation (e.g. 'DH').
player_name_first_lastcharacterParticipant name in first-last order.
votesdoubleNumber of votes received.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

mlb_award_recipients(award_id='MLBHOF')

Last validated n/a.