Get the scheduleGet the games on a date or across a date range, with each game's teams, start time, ballpark, status and final score. This is the usual starting point: every game comes back with the game id the boxscore, linescore and play-by-play actions take. Switch the schedule type to All events to see the non-game events on the calendar too, such as All-Star Weekend and ballpark tours.
Get the postseason scheduleGet a season's postseason games (Wild Card round through the World Series) with the same per-game detail as the regular schedule.
Get postseason seriesGet the postseason grouped into its series rather than as a flat list of games, so a workflow can read a matchup and its series status in one step.
Get postseason tune-in timesGet the postseason tune-in schedule: when each game starts and which broadcasters are carrying it.
List tied gamesList the games that ended level. Returns an empty list for seasons that had none, so a workflow can branch on the count.
Get a game's live feedGet everything MLB holds about one game in a single payload (the GUMBO feed): both rosters, the current state, every play and pitch, and the boxscore. This is the feed that powers Gameday and it updates while the game is in progress. It is a large response, so use "Fields to keep" to trim it to the parts your workflow needs.
Get a game's feed updatesGet only what changed in a game's live feed since a moment you already have, instead of downloading the whole feed again. Poll a game in progress with this: take the timestamp from your last feed, pass it as the start, and apply the patch you get back.
List a game's timestampsList every moment a game's feed can be rewound to, oldest first. Feed each one to Get a game's live feed to replay the game state by state.
Get a game's boxscoreGet a game's boxscore: each team's batting and pitching lines, the batting order, substitutions, the umpires and the team totals.
Get a game's linescoreGet a game's linescore: runs, hits and errors by inning, the current inning and count while a game is live, and who is due up next.
Get a game's play-by-playGet every play of a game in order, each with its batter and pitcher, the pitches thrown, the count, the runners and the outcome. Each pitch carries a play id, which is what the video and tracking data are keyed by.
Get a game's media and recapsGet the editorial content MLB published for a game: the written recap, the highlight videos with their playback URLs, and the photos.
Get a game's context metricsGet the situational context of a game as it stands: the leverage of the moment, each side's chance of winning, and the game's current state.
Get a game's win probabilityGet how each team's chance of winning moved play by play, so a workflow can find the swing that decided a game.
Get a game with Statcast metricsGet a game's full feed with the Statcast measurements attached to each play: pitch velocity and spin, exit velocity, launch angle and hit distance. Another large response, so trim it with "Fields to keep".
List changed gamesList the games whose data MLB has touched since a moment you give it (a rescheduled start, a corrected score, a scoring change). Use it to keep a local copy of the schedule in step without re-reading every game.
List teamsList teams with their names, abbreviations, home ballpark, league, division and first year of play. Narrow it to a sport level, a league or a division, or leave the sport level blank to get every affiliate MLB tracks.
Get a teamGet one team's record: its names and abbreviations, home ballpark, spring training home, league, division and first year of play.
Get a team's rosterGet the players on a team, each with their jersey number, position and roster status. Choose which roster: the active one, the 40-man, a full season including everyone who passed through, the depth chart, non-roster invitees, or the all-time roster.
List a team's affiliatesList the whole organisation behind a team: its major league club and every minor league affiliate from Triple-A down, each with its own team id.
List a team's historyList a franchise's history season by season: the names, cities, leagues and divisions it has played under, so a workflow can resolve what a club was called in a given year.
List a team's alumniList every player who appeared for a team in a season, which is broader than a roster: it includes everyone who came through on a call-up or a short stint.
List a team's coachesList a team's coaching staff (manager, bench, hitting and pitching coaches and the rest) with each person's job title.
List a team's personnelList a team's non-coaching personnel: the front office, trainers and support staff, each with their job title.
Get a team's statsGet one team's own statistics, in whichever split you ask for: a season total, year by year, a game log, home and away, by month, and so on.
Compare team statsGet a table of statistics across teams, ranked by whichever one you choose: the league table of team batting, pitching or fielding.
Get a team's leadersGet the players who lead one team in a statistic: who hit the most home runs for the Yankees this season, and by how much.
Get the leading teamsGet the teams that lead a statistic: which club scored the most runs or allowed the fewest.
Search for playersFind players by name and get their ids back, the usual first step when all you have is a name. Narrow the search to a sport level, a league, a team, a season, or to active players only.
Get a playerGet one person's record (a player, a coach or an umpire): full name, position, bats and throws, height and weight, birthplace, debut and current team.
Get several playersGet the records of several people in one request, which is much kinder to MLB's servers than looping one player at a time over a roster.
List a player's awardsList every award one player has won, with the season and the team they won it with.
Get a player's statsGet one player's statistics in whichever shape you need: a season line, a career total, year by year, a game log, a pitch log, splits against a given opponent, or by date range. Situational filters narrow it further: only with runners in scoring position, only against left-handers, only at home.
Get a player's line from a gameGet how one player did in one particular game: their batting, pitching and fielding line for that day.
List free agentsList a season's free agents, each with the team they left, the team they signed with, and the date they signed.
List changed playersList the players whose records MLB has touched since a moment you give it, so a local copy of the player database can be kept in step without re-reading all of it.
Get statsGet a table of statistics across players or teams: the general-purpose stats query. Pick the split and the stat group, then narrow by season, team, league, position, date range or situation, and sort by whichever statistic you like.
Get grouped statsGet statistics rolled up by a dimension of your choosing (by month, by ballpark, by opponent, by pitch type, by count) instead of one flat row per player. Use it to answer "how does this hitter do against sliders" in one step.
Get stat leadersGet the players who lead a statistic, ranked, with each leader's value and team: the league leaderboard for home runs, ERA, stolen bases or any of the other categories.
Get record highs and lowsGet the best and worst single performances on record for a statistic: the most home runs in a game by a player, the most runs by a team, the longest game. Choose whether to rank player, team or game records.
List milestonesList the career milestones players are approaching or have just reached: the 3,000th hit, the 500th home run, the 300th win. Filter to pending ones to know what is worth watching tonight.
Get the standingsGet the table for one or more leagues: each team's record, games behind, streak, run differential and clinch status. Choose the kind of table: the division race, the wild card picture, spring training, or a split-season half.
List leaguesList the leagues at a level of baseball, each with its season dates, whether it uses a designated hitter, and its league id.
Get a leagueGet one league's record, including its season dates and its rules on the designated hitter and the wild card.
Get the All-Star ballotGet a league's All-Star ballot for a season: the candidates at each position, with their team and their ballot position.
Get the All-Star Final VoteGet a league's All-Star Final Vote candidates: the players competing for the last roster spot.
Get All-Star write-insGet the write-in candidates on a league's All-Star ballot: the players fans named who were not printed on it.
Get the All-MLB ballotGet the whole-sport All-MLB ballot for a season: the candidates for the season-ending All-MLB team, across both leagues.
List divisionsList the divisions in a league or sport level, each with its id, abbreviation and the league it belongs to. Name a division to read just that one.
List conferencesList the conferences some minor leagues are organised into above the division level. Name a conference to read just that one.
List sport levelsList every level of baseball the API covers (Major League Baseball, each rung of the minors, winter, independent, college, high school, international, Olympic and Negro League Baseball), each with the id the other actions take.
List all players at a levelList every player at one level of baseball for a season: the whole of MLB in a single call, which is the quickest way to build a local player table.
List seasonsGet a season's key dates: when the regular season and postseason start and end, and how many games are scheduled. Returns the current season by default, one past season if you name it, or every season back to 1876.
List ballparksList the ballparks the API knows, or read one by id. Ask for extra data to get its location, capacity, field dimensions, roof type and timezone.
List draft picksList the players taken in a draft year, with the round and pick number, the team, the school and the signing bonus. Filter to one team, one round or one player.
List draft prospectsList the prospects eligible for a draft, ranked, with their position, school and home state: the board before the picks are made.
Get the latest draft pickGet the pick just made in a draft and the next five teams on the clock: what a live draft tracker reads.
List awardsList every award the API tracks (the MVPs, Cy Youngs, Gold Gloves, the Hall of Fame and each club's retired numbers) with the id you feed to the other award actions.
Get an awardGet one award's record by its id: its full name, the organization that gives it, and the notes MLB files it under.
List award recipientsList who has won an award, with the season and the team they won it with. Name a season for one year's winner, or leave it blank for the whole roll of honour.
List transactionsList roster moves (trades, signings, call-ups, options, injured list placements and releases), each with a plain English description. Choose a date or a date range, then narrow to a team, a player or a kind of move.
Get attendanceGet how many people came through the gates: a team's or a league's total, average, high and low attendance, split home and away.
Get pace of playGet how long games take: average game time, runs and pitches per game, and time per plate appearance, for a team, a league or a whole level of baseball.
Get broadcastersLook broadcasters up by id and get their name, call sign, whether they are TV or radio, and whether they are local or national. Get the schedule with broadcasts included to find the ids.
List people by jobList the people holding a job across baseball: any of the API's job types, from umpires and scouts to broadcasters and front-office roles.
List umpiresList the umpires on staff, with their uniform numbers.
List datacastersList the datacasters: the people who score games into the Stats API from the ballpark.
List official scorersList the official scorers: the people who rule on hits and errors.
Get replay review recordsGet how replay review went in a season: how many calls each team challenged, how many were overturned, and how long the reviews took.
Get a Home Run DerbyGet a Home Run Derby round by round, or just its bracket or its player pool. The derby's id is the All-Star Weekend event id: get the schedule for All-Star week with the "All events" type to find it.
Look up reference valuesRead any of the API's own lookup lists straight from MLB: the game types, stat groups and stat types, positions, pitch types and codes, event types, situation codes, roster and standings types, job types, replay review reasons, rule settings, and the rest. Use it when a workflow needs the current codes rather than hard-coded ones.