MLB GraphQL Reference
Every MLB game from spring training through the World Series — the 162-game regular season, the postseason bracket, plus the players, ballparks, umpires, weather, Statcast metrics, and pitch-by-pitch detail.
Every GraphQL type, relation, argument, and field — generated from the served schema, so it can never disagree with the API. Each column is documented inline; relations and foreign keys link straight to the type they resolve to. Root fields take the same filters as REST; requests are metered by rows resolved, nested lists included.
Main
MLBSeasonsFields (9)
idBigIntkeyPrimary Key
league_idStringnullableOfficial MLB season identifier
start_dateString2018-03-29T00:00:00.000Zend_dateStringnullable2018-10-28T00:00:00.000Zstart_yearInt2018regular_season_start_dateStringnullable2018-03-29T00:00:00.000Zpost_season_start_dateStringnullable2018-10-02T00:00:00.000Zcreated_atStringupdated_atStringRelations (11)
mlb.game_lines rows whose season_id references this row.
mlb.games rows whose season_id references this row.
mlb.park_factors rows whose season_id references this row.
mlb.player_awards rows whose season_id references this row.
mlb.player_injuries rows whose season_id references this row.
mlb.playoffs rows whose season_id references this row.
mlb.season_player_stats rows whose season_id references this row.
mlb.season_run_environments rows whose season_id references this row.
mlb.season_team_stats rows whose season_id references this row.
mlb.team_player_rosters rows whose season_id references this row.
mlb.woba_weights rows whose season_id references this row.
Arguments (2)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.
MLBTeamsFields (13)
idBigIntkeyPrimary Key
abbreviationStringLAAcityStringLos AngelesleagueStringAmerican LeagueValues:American LeagueNational LeaguedivisionStringWestValues:WestEastCentralfull_nameStringLos Angeles AngelsnameStringAngelsactiveBooleantrue2logo_urlStringnullableURL to team logo image
created_atStringupdated_atStringRelations (17)
The mlb.venues row referenced by venue_id; null when unlinked.
mlb.game_player_batter_stats rows whose team_id references this row.
mlb.game_player_pitching_stats rows whose team_id references this row.
mlb.game_team_rosters rows whose team_id references this row.
mlb.game_team_stats rows whose team_id references this row.
mlb.games rows whose away_team_id references this row.
mlb.games rows whose home_team_id references this row.
mlb.play_by_plays rows whose team_id references this row.
mlb.player_awards rows whose team_id references this row.
mlb.player_injuries rows whose team_id references this row.
mlb.player_news rows whose team_id references this row.
mlb.players rows whose team_id references this row.
mlb.season_team_stats rows whose team_id references this row.
mlb.team_player_rosters rows whose team_id references this row.
mlb.team_starting_lineups rows whose team_id references this row.
mlb.playoffs rows whose home_team_id references this row.
mlb.playoffs rows whose away_team_id references this row.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.activeBooleanFilter by active status (defaults to true to show only currently-active rows; pass active=false to include inactive).
MLBGamesseason_id.Fields (33)
idBigIntkeyPrimary Key
league_idStringnullableOfficial MLB game identifier
2025game_timeStringCanonical game start time (use this over start_time)
2018-03-17T17:05:00.000Z3338game_typeStringR=Regular, S=Spring, F=Wild Card, D=Division, L=League, W=World Series, E=Exhibition, A=All-Star
RValues:RSDFLWstatusStringFinal, Live, Scheduled, Postponed, Suspended, Cancelled
FinalValues:FinalCompleted EarlyCancelledend_timeStringnullableseason_typeStringCanonical season phase. Postseason round detail (Wild Card/Division/LCS/World Series) is in the league-native game_type code.
regular_seasonValues:regular_seasonspring_trainingpostseasondayInt2018031716channelStringnullableMLBN (out-of-market only)attendanceIntnullableaway_team_scoreInt3home_team_scoreInt4neutral_venueBooleanfalseseries_nameStringnullableRegular SeasonValues:Regular SeasonSpring TrainingNL Division SeriesAL Division SeriesAL Championship SeriesWorld SeriesAL Wild Card SeriesNL Wild Card SeriesNL Championship Seriesif_necessaryBooleannullablefalseseries_game_numberStringnullable1game_labelStringnullableRegular Season Game 1series_textStringnullable1-0Values:1-02-12-01-13-03-12-24-00-03-23-34-34-15-04-2postponed_statusStringnullabledoubleheaderBooleanfalseValues:falsetruegame_numberIntFor doubleheaders: 1 or 2
1created_atStringupdated_atStringwinning_pitcher_idBigIntnullableWinning pitcher of record
272losing_pitcher_idBigIntnullableLosing pitcher of record
1177save_pitcher_idBigIntnullableSave pitcher (if any)
1415duration_minutesIntnullableTotal game duration in minutes
day_nightStringnullableD=Day, N=Night
Relations (19)
The mlb.teams row referenced by away_team_id; null when unlinked.
The mlb.teams row referenced by home_team_id; null when unlinked.
The mlb.players row referenced by losing_pitcher_id; null when unlinked.
The mlb.players row referenced by save_pitcher_id; null when unlinked.
The mlb.seasons row referenced by season_id; null when unlinked.
The mlb.venues row referenced by venue_id; null when unlinked.
The mlb.players row referenced by winning_pitcher_id; null when unlinked.
mlb.at_bats rows whose game_id references this row.
mlb.game_lines rows whose game_id references this row.
mlb.game_player_batter_stats rows whose game_id references this row.
mlb.game_player_pitching_stats rows whose game_id references this row.
mlb.game_team_rosters rows whose game_id references this row.
mlb.game_team_stats rows whose game_id references this row.
mlb.game_umpires rows whose game_id references this row.
mlb.innings rows whose game_id references this row.
mlb.pitches rows whose game_id references this row.
mlb.play_by_plays rows whose game_id references this row.
mlb.team_starting_lineups rows whose game_id references this row.
mlb.venue_weathers rows whose game_id references this row.
Arguments (10)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.season_idIntFilter to a season. Defaults to the current season.home_team_idIntFilter by home team.away_team_idIntFilter by away team.statusStringFilter by game status.dayIntFilter by calendar day (YYYYMMDD integer, US Eastern) — e.g. day=20260609 for today's slate. season_id defaults to the current season; pass it explicitly for past-season days.day__gteIntgtecomparison onday.day__lteIntltecomparison onday.day__betweenStringRange filter onday— pass "lo,hi".
MLBPlayersteam_id | roster_status.Fields (31)
idBigIntkeyPrimary Key
league_idStringnullableOfficial MLB player identifier
first_nameStringRyanlast_nameStringRodriguezfull_nameStringLuis OrtizjerseyStringnullable52primary_positionStringPfull_position_listStringnullablePitcherValues:PitcherOutfielderCatcherSecond BaseThird BaseFirst BaseShortstopOutfieldDesignated HitterInfieldTwo-Way Player16league_slugStringnullableaustin-adams-613534position_categoryStringnullablePitcherValues:PitcherInfielderOutfielderCatcherUtilityheightIntnullable74weightIntnullable215birth_dateStringnullable1994-07-14T04:00:00.000Zbirth_cityStringnullableSanto Domingobirth_stateStringnullableCAbirth_countryStringnullableUSAschoolStringnullabledebut_dateStringnullable2023-03-30T00:00:00.000Zdisplay_last_comma_firstStringnullableDavis, Jonathandisplay_fi_lastStringnullableR. RodríguezbatsStringnullableRValues:RLSthrowsStringnullableRValues:RLSdraft_yearStringnullable2019draft_roundStringnullabledraft_numberStringnullableroster_statusStringnullableCanonical roster status, shared across leagues. Derived from team_player_rosters: "active" (26-man), "non_roster" (on the 40-man but optioned), "injured_reserve" (IL); "inactive"/"free_agent" off-roster. The "on a team now" set is {active, injured_reserve, non_roster}.
inactiveValues:inactiveactivenon_rosterinjured_reserveprofile_pic_urlStringnullableURL to player profile picture image
created_atStringupdated_atStringRelations (26)
The mlb.teams row referenced by team_id; null when unlinked.
mlb.at_bats rows whose batter_id references this row.
mlb.at_bats rows whose pitcher_id references this row.
mlb.game_player_batter_stats rows whose player_id references this row.
mlb.game_player_pitching_stats rows whose player_id references this row.
mlb.game_team_rosters rows whose player_id references this row.
mlb.games rows whose losing_pitcher_id references this row.
mlb.games rows whose save_pitcher_id references this row.
mlb.games rows whose winning_pitcher_id references this row.
mlb.operator_player_lookups rows whose player_id references this row.
mlb.pitches rows whose batter_id references this row.
mlb.pitches rows whose pitcher_id references this row.
mlb.play_by_plays rows whose batter_id references this row.
mlb.play_by_plays rows whose catcher_id references this row.
mlb.play_by_plays rows whose first_base_runner_id references this row.
mlb.play_by_plays rows whose pitcher_id references this row.
mlb.play_by_plays rows whose player_id references this row.
mlb.play_by_plays rows whose second_base_runner_id references this row.
mlb.play_by_plays rows whose third_base_runner_id references this row.
mlb.player_awards rows whose player_id references this row.
mlb.player_injuries rows whose player_id references this row.
mlb.player_news rows whose player_id references this row.
mlb.season_player_stats rows whose player_id references this row.
mlb.team_player_rosters rows whose player_id references this row.
mlb.team_starting_lineup_batters rows whose player_id references this row.
mlb.team_starting_lineups rows whose pitcher_id references this row.
Arguments (4)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.team_idIntFilter to players whose current team_id matches. Null team_id rows (free agents, retired) are excluded when this filter is applied.roster_statusStringFilter by canonical roster status. The "on a team now" set is {active, injured_reserve, non_roster} (active 26-man, injured list, and 40-man-but-optioned); free_agent/retired/inactive are off-roster.
Plays
MLBInningsgame_id.Fields (12)
idBigIntkeyPrimary Key
357inning_numberInt1inning_halfStringTOPValues:TOPBOTTOMhome_team_runsInt0away_team_runsInt0home_team_hitsInt0away_team_hitsInt0home_team_errorsInt0away_team_errorsInt0created_atStringupdated_atStringRelations (3)
The mlb.games row referenced by game_id; null when unlinked.
mlb.at_bats rows whose inning_id references this row.
mlb.play_by_plays rows whose inning_id references this row.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.game_idIntFilter to a single game.
MLBPitchesgame_id.Fields (74)
idBigIntkeyPrimary Key
play_idBigInt1284pitcher_idBigInt267batter_idBigInt306at_bat_idBigInt1494pitch_numberInt1pitch_typeStringnullableFFValues:FFSISLCHFCSTCUFSKCSVFApitch_speedFloatnullable92.6pitch_zoneIntnullable14strike_zone_topFloatnullable3.51strike_zone_bottomFloatnullable1.63pitch_xFloatnullable0.36271081581727094pitch_yFloatnullable155.85pitch_zFloatnullable3.5469804155056193plate_xFloatnullable125.18plate_zFloatnullable155.85extensionFloatnullable7.015639833312882break_angleFloatnullable1.2break_lengthFloatnullable3.6break_yFloatnullable24spin_rateFloatnullable2190spin_directionFloatnullable211resultStringBallValues:BallFoulCalled StrikeIn play, out(s)Swinging StrikeIn play, no outIn play, run(s)Ball In DirtFoul TipSwinging Strike (Blocked)Hit By PitchFoul BuntPitchoutMissed BuntcallStringBallValues:BallFoulCalled StrikeIn play, out(s)Swinging StrikeIn play, no outIn play, run(s)Ball In DirtFoul TipSwinging Strike (Blocked)Hit By PitchFoul BuntPitchoutMissed BuntstrikeBooleanfalseValues:falsetrueballBooleanfalseValues:falsetruein_playBooleanfalseValues:falsetruesingleBooleanWhether this pitch resulted in a single
falseValues:falsetruedoubleBooleanWhether this pitch resulted in a double
falseValues:falsetruetripleBooleanWhether this pitch resulted in a triple
falseValues:falsetruehome_runBooleanWhether this pitch resulted in a home run
falseValues:falsetruewalkBooleanWhether this pitch resulted in a walk
falseValues:falsetruestrikeoutBooleanWhether this pitch resulted in a strikeout
falseValues:falsetruehit_by_pitchBooleanWhether this pitch resulted in hit by pitch
falseValues:falsetruesacrifice_hitBooleanWhether this pitch resulted in a sacrifice bunt
falseValues:falsetruesacrifice_flyBooleanWhether this pitch resulted in a sacrifice fly
falseValues:falsetrueintentional_walkBooleanWhether this pitch resulted in an intentional walk
falseground_into_double_playBooleanWhether this pitch resulted in grounding into double play
falseground_into_triple_playBooleanWhether this pitch resulted in grounding into triple play
falsefly_outBooleanWhether this pitch resulted in a fly out
falseValues:falsetrueground_outBooleanWhether this pitch resulted in a ground out
falseValues:falsetrueline_outBooleanWhether this pitch resulted in a line out
falseValues:falsetruepop_outBooleanWhether this pitch resulted in a pop out
falseValues:falsetrueair_outBooleanWhether this pitch resulted in an air out
falsecatchers_interferenceBooleanWhether this pitch resulted in catchers interference
falsehit_exit_velocityFloatnullableExit velocity of batted ball (mph)
103.4hit_launch_angleFloatnullableLaunch angle of batted ball (degrees)
5hit_distanceIntnullableDistance of batted ball (feet)
4hit_coord_xFloatnullableHit coordinate X (feet from home plate)
153.39hit_coord_yFloatnullableHit coordinate Y (feet from home plate)
167.3spray_angleFloatnullableHorizontal angle from center field (degrees)
-6.1hard_hitBooleannullableExit velocity >= 95 MPH
falseValues:falsetruebarrelBooleannullableOptimal combination of exit velocity and launch angle
falseValues:falsetruesweet_spotBooleannullableLaunch angle between 8-32 degrees
falseValues:falsetrueunderBooleannullableLaunch angle less than 10 degrees
falseValues:falsetruetoppedBooleannullableLaunch angle < 10 AND exit velocity < 90
falseValues:falsetrueflare_burnerBooleannullableLaunch angle 10-25 AND exit velocity < 95
falseValues:falsetruesolid_contactBooleannullableLaunch angle 20-25 AND exit velocity 95-100
falseValues:falsetrueexpected_batting_avgFloatnullablexBA based on exit velocity and launch angle
expected_wobaFloatnullablexwOBA based on exit velocity and launch angle
launch_speed_angle_zoneIntnullable1=Weak, 2=Topped, 3=Under, 4=Flare/Burner, 5=Solid, 6=Barrel
3statcast_quality_scoreFloatnullableStatcast data quality score (0.0-1.0)
tracking_confidenceFloatnullableConfidence in tracking data accuracy
in_strike_zoneBooleannullableWhether pitch was in the strike zone
falseValues:falsetruechaseBooleannullableWhether batter swung at pitch outside zone
truefastballBooleannullableFastball variant (4-seam, 2-seam, sinker, cutter)
trueValues:truefalsebreaking_ballBooleannullableBreaking ball (curveball, slider, knuckleball)
falseValues:falsetrueoffspeedBooleannullableOffspeed pitch (changeup, splitter, forkball)
falseValues:falsetruespin_axisFloatnullableSpin axis (degrees)
release_speedFloatnullableSpeed at release point (mph)
92.6effective_speedFloatnullablePerceived speed to batter (mph)
85.3created_atStringupdated_atStringRelations (5)
The mlb.at_bats row referenced by at_bat_id; null when unlinked.
The mlb.players row referenced by batter_id; null when unlinked.
The mlb.games row referenced by game_id; null when unlinked.
The mlb.players row referenced by pitcher_id; null when unlinked.
The mlb.play_by_plays row referenced by play_id; null when unlinked.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.game_idIntFilter to a single game.
MLBAtBatsgame_id.Fields (37)
idBigIntkeyPrimary Key
69908pitcher_idBigInt174batter_idBigInt996at_bat_numberInt0start_outsInt1end_outsInt2start_runnersInt0end_runnersInt0runs_scoredInt0resultStringStrikeoutpitch_countInt4ballsInt0strikesInt2hit_typeStringnullableground_ballValues:ground_ballfly_ballline_drivepopupbunt_grounderbunt_popuphit_locationStringnullableground_ballValues:ground_ballfly_ballline_drivepopupbunt_grounderbunt_popuphit_distanceIntnullable4hit_exit_velocityFloatnullable98.4hit_launch_angleFloatnullable5hit_coord_xFloatnullable104.05hit_coord_yFloatnullable149.88is_hard_hitBooleannullablefalseValues:falsetrueis_barrelBooleannullablefalseValues:falsetrueexpected_batting_avgFloatnullable0.0050expected_wobaFloatnullable0.0000launch_speed_angle_zoneIntnullable3spray_angleFloatnullableHorizontal angle from center field (degrees)
-6is_sweet_spotBooleannullableLaunch angle between 8-32 degrees
falseValues:falsetrueis_underBooleannullableLaunch angle less than 10 degrees
falseValues:falsetrueis_toppedBooleannullableLaunch angle < 10 AND exit velocity < 90
falseValues:falsetrueis_flare_burnerBooleannullableLaunch angle 10-25 AND exit velocity < 95
falseValues:falsetrueis_solid_contactBooleannullableLaunch angle 20-25 AND exit velocity 95-100
falseValues:falsetruestatcast_quality_scoreFloatnullableStatcast data quality score (0.0-1.0)
1.0000tracking_confidenceFloatnullableConfidence in tracking data accuracy
created_atStringupdated_atStringRelations (6)
The mlb.players row referenced by batter_id; null when unlinked.
The mlb.games row referenced by game_id; null when unlinked.
The mlb.innings row referenced by inning_id; null when unlinked.
The mlb.players row referenced by pitcher_id; null when unlinked.
mlb.pitches rows whose at_bat_id references this row.
mlb.play_by_plays rows whose at_bat_id references this row.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.game_idIntFilter to a single game.
MLBPlayByPlaysgame_id.Fields (25)
idBigIntkeyPrimary Key
play_idBigInt0mlb_event_numInt06990899619event_typeInt8event_sub_typeInt0descriptionStringcount_ballsInt0count_strikesInt2outsInt1runners_on_baseInt0pitcher_idBigIntnullable174batter_idBigIntnullable996catcher_idBigIntnullablefirst_base_runner_idBigIntnullable996second_base_runner_idBigIntnullable996third_base_runner_idBigIntnullable996hit_locationStringnullableground_ballValues:ground_ballfly_ballline_drivepopupbunt_grounderbunt_popuphit_typeStringnullableground_ballValues:ground_ballfly_ballline_drivepopupbunt_grounderbunt_popupat_bat_idBigIntnullable1created_atStringupdated_atStringRelations (12)
The mlb.at_bats row referenced by at_bat_id; null when unlinked.
The mlb.players row referenced by batter_id; null when unlinked.
The mlb.players row referenced by catcher_id; null when unlinked.
The mlb.players row referenced by first_base_runner_id; null when unlinked.
The mlb.games row referenced by game_id; null when unlinked.
The mlb.innings row referenced by inning_id; null when unlinked.
The mlb.players row referenced by pitcher_id; null when unlinked.
The mlb.players row referenced by player_id; null when unlinked.
The mlb.players row referenced by second_base_runner_id; null when unlinked.
The mlb.teams row referenced by team_id; null when unlinked.
The mlb.players row referenced by third_base_runner_id; null when unlinked.
mlb.pitches rows whose play_id references this row.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.game_idIntFilter to a single game.
Stats
MLBSeasonTeamStatsseason_id.Fields (38)
idBigIntkeyPrimary Key
162024games_playedInt162winsInt90lossesInt72tiesInt0runs_scoredInt769runs_allowedInt699at_batsInt5522hitsInt1423doublesInt264triplesInt12home_runsInt182runs_batted_inInt655stolen_basesInt88caught_stealingInt30walksInt478strikeoutsInt1461batting_averageFloat0.2440on_base_percentageFloat0.3150slugging_percentageFloat0.3960on_base_plus_sluggingFloat0.7070innings_pitchedFloatInnings pitched in MLB notation (6.2 = 6 and 2/3 innings)
1442.0000earned_runsInt596earned_run_averageFloat3.7400whipFloat1.2400complete_gamesInt0shutoutsInt8savesInt40save_opportunitiesInt64holdsInt83blown_savesInt28errorsInt97fielding_percentageFloat0.9840double_playsInt125created_atStringupdated_atStringRelations (2)
The mlb.seasons row referenced by season_id; null when unlinked.
The mlb.teams row referenced by team_id; null when unlinked.
Arguments (4)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.season_idIntFilter to a season. Defaults to the current season.team_idIntFilter by team.
MLBGamePlayerBatterStatsgame_id | player_id.Fields (44)
idBigIntkeyPrimary Key
6441604at_batsInt3plate_appearancesInt4runsInt0hitsInt0singlesInt0doublesInt0triplesInt0home_runsInt0runs_batted_inInt0batting_averageFloat0.0000stolen_basesInt0caught_stealingInt0strikeoutsInt0walksInt0hit_by_pitchInt0sacrificesInt0sacrifice_fliesInt0ground_into_double_playInt0ground_into_triple_playInt0on_base_percentageFloat0.0000slugging_percentageFloat0.0000on_base_plus_sluggingFloat0.0000total_basesInt0fly_outsInt0ground_outsInt0line_outsInt0pop_outsInt0air_outsInt0intentional_walksInt0left_on_baseInt0balls_in_playInt0babipFloat0.0000isolated_powerFloat0.0000wobaFloat0.0000double_playsInt0catchers_interferenceInt0pickoffsInt0at_bats_per_home_runFloat0.0000created_atStringupdated_atStringRelations (3)
The mlb.games row referenced by game_id; null when unlinked.
The mlb.players row referenced by player_id; null when unlinked.
The mlb.teams row referenced by team_id; null when unlinked.
Arguments (4)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.game_idIntFilter to a single game.player_idIntFilter to a single player.
MLBGamePlayerPitchingStatsgame_id | player_id.Fields (70)
idBigIntkeyPrimary Key
64331382winInt0lossInt0saveInt0holdInt0blown_saveInt0innings_pitchedFloatInnings pitched in MLB notation (6.2 = 6 and 2/3 innings)
1.0000hits_allowedInt0runs_allowedInt0earned_runsInt0walks_allowedInt0strikeouts_pitchedInt0home_runs_allowedInt0batters_facedInt3pitches_thrownInt0strikesInt0earned_run_averageFloat0.0000whipFloat0.0000singles_allowedInt0doubles_allowedInt0triples_allowedInt0grand_slams_allowedInt0hit_by_pitchInt0sacrifices_allowedInt0sacrifice_flies_allowedInt0ground_into_double_playInt0complete_gamesInt0shutoutsInt0no_hittersInt0perfect_gamesInt0plate_appearancesInt0total_bases_allowedInt0fly_outsInt0ground_outsInt0line_outsInt0pop_outsInt0air_outsInt0intentional_walksInt0balls_in_playInt0on_base_percentageFloat0.0000slugging_percentageFloat0.0000on_base_plus_sluggingFloat0.0000strikeouts_per_nineFloat0.0000walks_per_nineFloat0.0000home_runs_per_nineFloat0.0000runs_scored_per_nineFloat0.0000babipFloat0.0000wobaFloat0.0000double_playsInt0fipFloat3.1000quality_startsInt0inning_startedInt0left_on_baseFloat0.0000strike_percentageFloat0.0000ballsInt0balksInt0wild_pitchesInt0pickoffsInt0inherited_runnersInt0inherited_runners_scoredInt0games_pitchedInt1games_startedInt0games_finishedInt0outsInt3catchers_interferenceInt0created_atStringupdated_atStringRelations (3)
The mlb.games row referenced by game_id; null when unlinked.
The mlb.players row referenced by player_id; null when unlinked.
The mlb.teams row referenced by team_id; null when unlinked.
Arguments (4)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.game_idIntFilter to a single game.player_idIntFilter to a single player.
MLBGameTeamStatsgame_id.Fields (39)
idBigIntkeyPrimary Key
145427winInt0lossInt0runsInt3hitsInt7errorsInt0left_on_baseInt6doublesInt1triplesInt0home_runsInt1runs_batted_inInt2stolen_basesInt0caught_stealingInt0walksInt2strikeoutsInt8hit_by_pitchInt0sacrifice_hitsInt0sacrifice_fliesInt0grounded_into_double_playInt0batting_averageFloat0.2440on_base_percentageFloat0.3150slugging_percentageFloat0.4070on_base_plus_sluggingFloat0.7240innings_pitchedFloatInnings pitched in MLB notation (6.2 = 6 and 2/3 innings)
9.0000earned_runsInt2earned_run_averageFloat3.7700batters_facedInt36pitches_thrownInt143strikesInt93wild_pitchesInt0balksInt0putoutsInt27assistsInt9double_plays_turnedInt0passed_ballsInt0created_atStringupdated_atStringRelations (2)
The mlb.games row referenced by game_id; null when unlinked.
The mlb.teams row referenced by team_id; null when unlinked.
Arguments (4)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.game_idIntFilter to a single game.team_idIntFilter by team.
MLBSeasonPlayerStatsseason_id | player_id.Fields (71)
idBigIntkeyPrimary Key
14392024games_playedInt0games_startedInt0at_batsInt0plate_appearancesInt0hitsInt0doublesInt0triplesInt0home_runsInt0runsInt0runs_batted_inInt0stolen_basesInt0caught_stealingInt0walksInt0strikeoutsInt0hit_by_pitchInt0sacrifice_hitsInt0sacrifice_fliesInt0grounded_into_double_playInt0batting_averageFloat0.0000on_base_percentageFloat0.0000slugging_percentageFloat0.0000on_base_plus_sluggingFloat0.0000winsInt0lossesInt0games_pitchedInt0games_started_pitchingInt0complete_gamesInt0shutoutsInt0savesInt0save_opportunitiesInt0holdsInt0blown_savesInt0innings_pitchedFloatInnings pitched in MLB notation (6.2 = 6 and 2/3 innings)
0.0000hits_allowedInt0runs_allowedInt0earned_runsInt0walks_allowedInt0strikeouts_pitchedInt0home_runs_allowedInt0batters_facedInt0earned_run_averageFloat0.0000whipFloat0.0000strikeouts_per_nineFloat0.0000walks_per_nineFloat0.0000hits_per_nineFloat0.0000home_runs_per_nineFloat0.0000fielding_positionStringPValues:PC2BLFRFCF3B1BSSXDHfielding_gamesInt0fielding_games_startedInt0total_chancesInt0putoutsInt0assistsInt0errorsInt0double_playsInt0fielding_percentageFloat0.0000passed_ballsInt0stolen_bases_allowedInt0caught_stealing_byInt0created_atStringupdated_atStringsinglesIntnullableDerivable from hits - doubles - triples - home_runs
0total_basesIntnullableDerivable: 1B + 2*2B + 3*3B + 4*HR
0intentional_walksIntnullable0left_on_baseIntnullable0pitches_thrownIntnullable0strikesIntnullable0ballsIntnullable0quality_startsIntnullable0Relations (2)
The mlb.players row referenced by player_id; null when unlinked.
The mlb.seasons row referenced by season_id; null when unlinked.
Arguments (4)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.season_idIntFilter to a season. Defaults to the current season.player_idIntFilter to a single player.
Advanced Stats
MLBParkFactorsvenue_id.Fields (20)
idBigIntkeyPrimary Key
122024home_run_factorFloatPark factor for home runs (1.0 = neutral)
1.3300single_factorFloatPark factor for singles
1.1100double_factorFloatPark factor for doubles
1.2600triple_factorFloatPark factor for triples
1.4200walk_factorFloatPark factor for walks
1.0100strikeout_factorFloatPark factor for strikeouts
0.8900left_handed_factorFloatPark factor for left-handed batters
1.1400right_handed_factorFloatPark factor for right-handed batters
1.1800basic_park_factorFloatOverall park factor for runs (1.0 = neutral)
1.2200handedness_factorFloatPark effect on handedness advantage
1.1600years_of_dataIntNumber of years used to calculate factors
3updated_dateString2026-04-12T02:04:46.363Zcreated_atStringupdated_atStringfly_ball_factorFloatnullablePark factor for fly balls
ground_ball_factorFloatnullablePark factor for ground balls
run_factorFloatnullablePark factor for total runs
Relations (2)
The mlb.seasons row referenced by season_id; null when unlinked.
The mlb.venues row referenced by venue_id; null when unlinked.
Arguments (4)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.venue_idIntFilter by venue.season_idIntFilter to a season.
MLBSeasonRunEnvironmentsseason_id.Fields (12)
idBigIntkeyPrimary Key
2021runs_per_plate_appearanceFloatLeague average runs per plate appearance
0.1250runs_per_outFloatLeague average runs per out made
0.2810home_run_per_fly_ballFloatLeague average HR/FB rate
0.1390batting_average_on_balls_in_playFloatLeague average BABIP
0.2930strikeout_rateFloatLeague average strikeout rate
0.2440walk_rateFloatLeague average walk rate
0.0890fip_constantFloatFIP constant to scale FIP to ERA
3.1340updated_dateString2026-04-12T02:04:46.337Zcreated_atStringupdated_atStringRelations (1)
The mlb.seasons row referenced by season_id; null when unlinked.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.season_idIntFilter to a season. Defaults to the current season.
MLBWobaWeightsFields (14)
idBigIntkeyPrimary Key
2021walk_weightFloatWeight for unintentional walks (wBB)
0.6920hit_by_pitch_weightFloatWeight for hit by pitch (wHBP)
0.7230single_weightFloatWeight for singles (w1B)
0.8950double_weightFloatWeight for doubles (w2B)
1.2710triple_weightFloatWeight for triples (w3B)
1.5520home_run_weightFloatWeight for home runs (wHR)
2.1010league_wobaFloatLeague average wOBA for the season
0.3180league_obpFloatLeague average OBP for calibration
0.3180woba_scaleFloatScale factor to convert wOBA to runs
1.2160updated_dateStringWhen these weights were last updated
2026-04-12T02:04:46.328Zcreated_atStringupdated_atStringRelations (1)
The mlb.seasons row referenced by season_id; null when unlinked.
Arguments (2)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.
Odds
MLBGameLinesgame_id.Fields (20)
idBigIntkeyPrimary Key
162977spreadFloatnullableHome team run line (e.g., -1.5 means home favored by 1.5 runs)
1.5000spread_home_oddsIntnullableAmerican odds for home run line (e.g., -130)
-110spread_away_oddsIntnullableAmerican odds for away run line
-110moneyline_homeIntnullableAmerican odds for home team win
-105moneyline_awayIntnullableAmerican odds for away team win
109totalFloatnullableCombined run total line (e.g., 8.5)
8.5000over_oddsIntnullableAmerican odds for over
-110under_oddsIntnullableAmerican odds for under
-110implied_home_scoreFloatnullableCalculated from spread + total
3.5000implied_away_scoreFloatnullable5.0000implied_home_win_pctFloatnullableFrom moneyline, 0-1
0.5122implied_away_win_pctFloatnullable0.4785captured_atStringWhen this snapshot was captured
2026-06-21T16:09:37.291Zis_openingBooleanTrue if this is the opening line
falseValues:falsetruecreated_atStringupdated_atStringRelations (3)
The mlb.games row referenced by game_id; null when unlinked.
The main.operators row referenced by operator_id; null when unlinked.
The mlb.seasons row referenced by season_id; null when unlinked.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.game_idIntFilter to a single game.
Lineups & Roster
MLBGameTeamRostersgame_id.Fields (12)
idBigIntkeyPrimary Key
14259271365positionStringnullablePValues:PC2BLF1BCF3BRFSSPHDHPRstatusStringnullableActivecommentStringnullablestarterBooleanfalseValues:falsetruedayInt20180929batting_orderIntnullable9created_atStringupdated_atStringRelations (3)
The mlb.games row referenced by game_id; null when unlinked.
The mlb.players row referenced by player_id; null when unlinked.
The mlb.teams row referenced by team_id; null when unlinked.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.game_idIntFilter to a single game.
MLBTeamPlayerRostersteam_id.Fields (11)
idBigIntkeyPrimary Key
301652024positionStringnullablePValues:PCRF3BLF2B1BCFSSDHOFIFTWPposition_groupStringnullablePitcherValues:PitcherInfielderOutfielderCatcherHitterTwo-Way Playerroster_typeString40ManValues:40ManactivefullSeasonposition_depthIntnullable1dayInt172created_atStringupdated_atStringRelations (3)
The mlb.players row referenced by player_id; null when unlinked.
The mlb.seasons row referenced by season_id; null when unlinked.
The mlb.teams row referenced by team_id; null when unlinked.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.team_idIntFilter by team.
MLBTeamStartingLineupBattersteam_starting_lineup_id.Fields (7)
idBigIntkeyPrimary Key
team_starting_lineup_idBigInt11040batting_orderString1positionStringSSValues:SS3BRF2BCF1BLFCDHPPHPRcreated_atStringupdated_atStringRelations (2)
The mlb.players row referenced by player_id; null when unlinked.
The mlb.team_starting_lineups row referenced by team_starting_lineup_id; null when unlinked.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.team_starting_lineup_idIntFilter to a single starting lineup.
MLBTeamStartingLineupsteam_id | game_id.Fields (8)
idBigIntkeyPrimary Key
2764pitcher_idBigIntnullable50028pitcher_statusInt1batter_statusInt1created_atStringupdated_atStringRelations (4)
The mlb.games row referenced by game_id; null when unlinked.
The mlb.players row referenced by pitcher_id; null when unlinked.
The mlb.teams row referenced by team_id; null when unlinked.
mlb.team_starting_lineup_batters rows whose team_starting_lineup_id references this row.
Arguments (4)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.team_idIntFilter by team.game_idIntFilter to a single game.
Misc
MLBVenuesFields (23)
idBigIntkeyPrimary Key
nameStringSutter Health ParklongitudeFloatnullable-82.5055latitudeFloatnullable27.9778elevationFloatnullableElevation in feet above sea level
596orientationFloatnullableField orientation in degrees (0-360). Direction home plate faces. 0/360=North, 90=East, 180=South, 270=West
45descriptionStringnullablecityStringWest SacramentostateStringnullableCAValues:CAFLILOHTXMONYPAAZGAMDMACOMIWIMNWAONDCcountryStringnullableUSAValues:USACANcapacityIntnullable14014surfaceStringnullableGrassValues:GrassArtificial TurfNatural Grassroof_typeStringnullableOpen, Dome, Retractable
OpenValues:OpenRetractableClosedopened_dateStringnullable2000-05-15T04:00:00.000Zclosed_dateStringnullableteam_nameStringnullableTampa Bay RaystimezoneStringnullableIANA timezone (e.g., America/New_York)
addressStringnullableimage_urlStringnullableURL to aerial/overview image of ballpark
hr_factorFloatnullableHistorical home run park factor (1.0 = neutral)
created_atStringupdated_atStringRelations (5)
mlb.games rows whose venue_id references this row.
mlb.park_factors rows whose venue_id references this row.
mlb.teams rows whose venue_id references this row.
mlb.venue_dimensions rows whose venue_id references this row.
mlb.venue_weathers rows whose venue_id references this row.
Arguments (2)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.
MLBUmpiresFields (13)
idBigIntkeyPrimary Key
first_nameStringMikelast_nameStringJimenezfull_nameStringCB Bucknor427044experienceIntnullableactiveBooleantruebirth_dateStringnullablebirth_cityStringnullablebirth_stateStringnullablebirth_countryStringnullablecreated_atStringupdated_atStringRelations (1)
mlb.game_umpires rows whose umpire_id references this row.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.activeBooleanFilter by active status (defaults to true to show only currently-active rows; pass active=false to include inactive).
MLBVenueDimensionsvenue_id.Fields (23)
idBigIntkeyPrimary Key
1venue_nameStringnullableAngel StadiumyearInt20002foul_territory_sq_ftFloatnullable21500fair_territory_sq_ftFloatnullable113800total_territory_sq_ftFloatnullable137000descriptionStringnullableorientationFloat45left_fieldFloat330left_center_fieldFloatnullable385center_fieldFloat400right_center_fieldFloatnullable375right_fieldFloat330left_field_fence_heightFloat8right_field_fence_heightFloat8center_field_fence_heightFloat8created_atStringupdated_atStringbackstop_distanceFloatnullableDistance from home plate to backstop (feet)
foul_territory_ratingFloatnullableRelative foul territory size (1.0 = average, >1 = large)
altitude_ftFloatnullableVenue altitude in feet (denormalized from venue for query convenience)
Relations (1)
The mlb.venues row referenced by venue_id; null when unlinked.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.venue_idIntFilter by venue.
MLBPlayoffsFields (14)
idBigIntkeyPrimary Key
2020series_idBigInt401series_nameStringAL Division SeriesValues:AL Division SeriesNL Division SeriesAL Wild Card SeriesNL Wild Card SeriesWorld SeriesNL Championship SeriesAL Championship SeriesNL Wild Card GameAL Wild Card Game2744home_team_winsInt3away_team_winsInt2games_playedInt5max_gamesInt5statusStringCompletedseries_textStringLAD won 4-3created_atStringupdated_atStringRelations (3)
The mlb.seasons row referenced by season_id; null when unlinked.
The mlb.teams row referenced by home_team_id; null when unlinked.
The mlb.teams row referenced by away_team_id; null when unlinked.
Arguments (2)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.
MLBGameUmpiresgame_id.Fields (6)
idBigIntkeyPrimary Key
145446positionStringnullableHome PlateValues:Home PlateFirst BaseSecond BaseThird Basecreated_atStringupdated_atStringRelations (2)
The mlb.games row referenced by game_id; null when unlinked.
The mlb.umpires row referenced by umpire_id; null when unlinked.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.game_idIntFilter to a single game.
MLBOperatorPlayerLookupsoperator_id.Fields (8)
idBigIntkeyPrimary Key
Operator id: 1 DraftKings, 2 FanDuel, 3 Yahoo, 13 sportsdata.io.
2240player_nameStringnullablePlayer name for reconciliation
Max MuncypositionStringnullablePosition for reconciliation
PValues:PCLF2BSSCFRF3B1BSPRPDHOFTWPcreated_atStringupdated_atStringRelations (2)
The main.operators row referenced by operator_id; null when unlinked.
The mlb.players row referenced by player_id; null when unlinked.
Arguments (3)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.operator_idIntFilter by operator.
MLBPlayerAwardsplayer_id.Fields (10)
idBigIntkeyPrimary Key
13692019award_typeStringMLBAFIRSTis_winnerBooleanstatsapi publishes recipients (winners) only — always true
truecreated_atStringupdated_atStringaward_nameStringAll-MLB First Teamaward_dateStringnullableDate the award was announced
2025-11-13T05:00:00.000Z41Relations (3)
The mlb.players row referenced by player_id; null when unlinked.
The mlb.seasons row referenced by season_id; null when unlinked.
The mlb.teams row referenced by team_id; null when unlinked.
Arguments (4)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.player_idIntFilter to a single player.season_idIntFilter to a season.
MLBPlayerInjuriesplayer_id.Fields (18)
idBigIntkeyPrimary Key
636422026start_dateString2026-05-08T11:02:00.000Zend_dateStringnullablestatusString60-Day-ILValues:60-Day-ILDay-To-Day15-Day-IL10-Day-ILOut7-Day ILdevelopmental listsuspension7-day ilBereavementpaternitybody_partStringElbowinjury_typeStringSurgeryValues:SurgeryStrainNot SpecifiedInflammationSorenessFracturePinched NerveSprainUnknownBruiseConcussionTendinitisSpasmsPlantar FasciitisCrampsBone SpurInfectionDislocatedsideStringnullableRightValues:RightLeftNot SpecifieddescriptionStringnullablenois_surgery_requiredBooleannullableexpected_return_dateStringnullable2027-02-01T05:00:00.000Zgames_missedIntnullableupdated_dateString2026-06-29T11:01:04.968ZsourceStringnullableespncreated_atStringupdated_atStringRelations (3)
The mlb.players row referenced by player_id; null when unlinked.
The mlb.seasons row referenced by season_id; null when unlinked.
The mlb.teams row referenced by team_id; null when unlinked.
Arguments (4)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.player_idIntFilter to a single player.team_idIntFilter by team.
MLBPlayerNewsplayer_id | team_id.Fields (19)
idBigIntkeyPrimary Key
459titleStringJake Bauers is Becoming a Must-Have PlayerdescriptionStringnullableMilwaukee Brewers first baseman/outfielder Jake Bauers is posting strong numbers at the plate recen…analysisStringnullablesourceStringNews source identifier (cbs, espn, rotoworld, sportsdata, etc.)
sportsdatalinkStringnullablehttps://www.rotoballer.com/player-news/jake-bauers-is-becoming-a-must-have-player/1871934news_timeString2026-06-07T01:57:06.000ZpriorityInt10created_atStringupdated_atStringai_processedBooleanfalsesituational_impactJSONnullablecontentStringnullableMilwaukee Brewers first baseman/outfielder Jake Bauers is posting strong numbers at the plate recen…categoryStringnullableinjury, transaction, lineup, general
injuryValues:injurytransactionlineupgeneralexternal_idStringSource-specific unique identifier
sportsdata-197163processed_atStringnullableRelations (2)
The mlb.players row referenced by player_id; null when unlinked.
The mlb.teams row referenced by team_id; null when unlinked.
Arguments (8)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.player_idIntFilter to a single player.team_idIntFilter by team.news_timeStringFilter by publication time (ISO 8601). Use news_time__gte to poll for items since your last check.news_time__gteStringgtecomparison onnews_time.news_time__lteStringltecomparison onnews_time.news_time__betweenStringRange filter onnews_time— pass "lo,hi".
MLBVenueWeathersgame_id.Fields (29)
idBigIntkeyPrimary Key
145414time_minutesIntMinutes from game start (0, 30, 60, 90, 120, 150, 180 for 3-hour game)
0temperatureFloatnullable72feels_like_temperatureFloatnullablehumidityFloatnullabledew_pointFloatnullablepressureFloatnullablewind_speedFloatnullable0wind_directionFloatnullablewind_gustFloatnullablevisibilityFloatnullableuv_indexFloatnullablecloud_coverFloatnullableprecipitationFloatnullableprecipitation_probabilityFloatnullableweather_conditionStringnullablePartly CloudyValues:Partly CloudyClearCloudyRoof ClosedSunnyOvercastDomeRainDrizzleSnowweather_descriptionStringnullableNoneValues:NoneOut To CFL To RR To LOut To LFOut To RFIn From RFIn From CFIn From LFVariesCalmis_domeBooleannullablefalseValues:falsetrueroof_statusStringnullableopen, closed, retractable_open, retractable_closed
ClosedValues:ClosedOpenrecorded_atStringnullable2018-09-30T19:10:00.000Zwind_direction_relativeFloatnullableWind direction relative to batter's box (degrees)
air_densityFloatnullableCalculated air density (lb/ft³)
created_atStringupdated_atStringwind_blowing_outBooleannullableTrue if wind is blowing from home plate toward outfield
trueValues:truefalsewind_component_outFloatnullableWind speed component blowing out to CF (mph, negative = blowing in)
ball_carry_factorFloatnullableEstimated ball carry factor (1.0 = neutral, >1 = carries more)
Relations (2)
The mlb.games row referenced by game_id; null when unlinked.
The mlb.venues row referenced by venue_id; null when unlinked.
Arguments (4)
firstIntPage size; clamped to the table's REST default/max limits.afterBigIntKeyset cursor — returns rows with id > after, ordered by id ascending.game_idIntFilter to a single game.venue_idIntFilter by venue.