Introduction
Sportradar is the Official Provider of real-time MLB statistics. The data collection comes direct from the MLB operations teams on-venue. This provides lightning speed and the highest-quality stats available to power your baseball experiences. All MLB games – including Spring Training – feature full coverage.
The MLB API is consistent in structure, format, and behavior with our other League Specific APIs. Our primary feeds return schedules, standings, team/player data, and real-time scores.
Our other MLB feeds provide a host of complementary statistics and information, including:
- Injuries
- Transactions
- Pitch metrics
- League leaders
- Venues
- Depth charts
- Season statistics
- Seasonal splits
Real-time customers are also offered three delivery Push Feeds to enhance speed.
Statcast Data
An extra package containing MLB Statcast data is also available, beginning at the start of the 2020 season. This package includes:
- Premium Deeper Pitch Data featuring spin rate, vertical and horizontal movement and more specific pitch types
- Premium Hit Data including exit velocity, launch angle, spin rate and project home run distance
- Premium Play Level Statcast Data containing deeper information on fielding and base-running performance
After gaining access to Statcast, use tracking (production) or trial-tracking (trial) in your API requests. Statcast data is available in the following endpoints: Event Tracking, Play-by-Play, Player Profile, Statcast Leaders .
Click here for a comprehensive list of Statcast metrics and their definitions.
See our MLB Integration GuideExplore our MLB API Integration Guide for detailed, step-by-step guidance on how to build applications using our MLB API.
API Map
To best utilize the MLB API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.
The primary feeds require only a date or season to call the endpoints. Those feeds provide Game, Team, or Player Ids which can be used to generate the game, team, and player feeds. All of the other feeds require no variables.
See below for descriptions of each feed.
Endpoint Descriptions
Awards List – Provides a list of all MLB awards available in the API.
Daily Box Score – Inning-by-inning scoring breakdown, top-level runs, hits and errors by team, as well as details on run-scoring events for all games on a given MLB defined day.
Daily Change Log – Provides IDs and timestamps for teams, players, game statistics, schedules, and standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.
Daily Schedule – The date, time and location for all games on a given MLB defined day.
Daily Summary – Team lineups as well as team and player statistics for all games on a given MLB defined day.
Daily Transactions – Provides information for all transfers created during the league-defined day, regardless of the transaction's effective date.
Event Tracking – Provides in-depth tracking information for all players on the field during a given event.
Free Agents – Provides a list of all current free agents in the league.
Game Boxscore – Inning-by-inning scoring breakdown, hits and errors by team, win/loss results, as well as details on run-scoring events for a given game.
Game Extended Summary – Inning-by-inning scoring, key game events, lineups, and team and player statistics for the given game and season-to-date.
Game Pitch Metrics – Detailed metrics on pitch type, velocity, and results for all pitchers in a given game.
Game Play Statistics – Provides hitting, pitching, and fielding statistics for each individual pitch of a given game.
Game Play-By-Play – Detailed, real-time information on every pitch and game event. Includes advanced Statcast data for every pitch and hit.
Game Summary – Team lineups as well as team and player statistics for a given game.
Glossary – Full text descriptions for pitch ids, player status ids, outcome ids, and game status ids.
Injuries – Information concerning all current injuries across the league.
League Depth Charts – Current depth chart positions for every MLB team.
League Hierarchy – Provides top-level information for each team, including league and division distinction, and venue information.
League Leaders – AL, NL, and MLB leader information for various hitting and pitching statistics.
League Schedule – Complete schedule information for a given season, including venue and broadcast info.
Officials – Provides a complete list of officials in the MLB API database.
Player Profile – Player biographical information, including current and historical seasonal statistics and splits.
Rankings – League and division rank for each team, including post season clinching status.
Seasonal Awards – Provides a list of all MLB awards for a given season and season type.
Seasonal Pitch Metrics – Detailed metrics on pitch type, velocity, and results for a given pitcher by season.
Seasonal Splits – Detailed splits for a given team and all players on the roster.
Seasonal Statistics – Detailed season-to-date stats for given team and all players on the roster.
Seasons – Provides a complete list of historical season information available in the API.
Series Schedule – Postseason participant information as well as the date, time, location, and other event details for every match-up taking place for the entire postseason.
Series Statistics – Provides detailed statistics for a given postseason series and participating team.
Series Summary – Team and player statistics for a given postseason series.
Standings – Detailed standings information for each MLB division.
Statcast Leaders – Statcast leader information for various hitting and pitching statistics.
Team Depth Chart – Current depth chart for all positions on a given team.
Team Full Roster – Returns all players associated with a given team, including approximately 100 minor league players who are not on the 40-man roster. This endpoint does not include every player in the team’s minor league system.
Team Profile – Top-level team information including all players currently on the 25-man roster, 40-man roster, or expected to join the team.
Teams – Provides a complete list of active teams in the MLB API database.
Venues – Provides the name, location, and capacity of each venue, along with the dimensions of each field.
Push Events – Provides detailed, real-time information on every game event.
Push Linescore – Provides real-time high level scoring by inning.
Push Probable Pitchers – Provides real-time updates to probable pitchers for upcoming games.
Push Statistics – Provides real-time game stats at the player level for all live games.
Data Retrieval Examples
To find how many home runs a team has hit when playing at home:
- Call the League or Season Schedule and find the Team Id
- Call the Seasonal Splits using the Team Id
- Find the Home Game statistics, Hitting element, with the Home Run attribute
The home teams number of home runs is displayed.
To find the away teams starting pitcher for a game:
- Call the league or season schedule and find id for the game you want
- Call the Game Boxscore using the Game ID
- Find the Away Team Starting Pitcher element with the First and Last Name attributes
The starting pitchers name is displayed.
Coverage Levels
We provide three different levels of detail to ensure maximum coverage.
Full – We provide live pitch-by-pitch coverage for the entire game. We provide updated live events as well as team- and player-level data in near real time. Full coverage is available for all regular and postseason games.
Boxscore – We provide runs by inning, along with total runs, hits, and errors, updated in near real time as the game progresses. Boxscore-only coverage applies in two Spring Training scenarios:
- When an MLB team plays a non-MLB opponent, such as a college team or a World Baseball Classic team. These exhibition games may follow modified rules that supersede the official MLB ruleset.
- When Boxscore coverage is required as a failover during Spring Training.
Spring Training – We provide live play-by-play coverage, including all events where an out was recorded or a runner advanced, as well as team and player data in near real-time. Beginning with the 2026 season, all Spring Training games played between two MLB franchises—at either Grapefruit/Arizona Cactus League venues or standard MLB stadiums—feature full pitch-by-pitch coverage.
Spring Training Coverage Note:Due to varying game rules, limited on-site staff, and training of new on-venue statisticians, you may see data volatility (e.g. stat errors and prolonged game-closing process) for Spring Training games. As a result, there may be a higher than normal frequency of games with data latency or moving to fail-over mode throughout Spring Training.
Failover Events
In the event the MLB feed goes down or begins reporting errors, Sportradar takes over Live Data Entry (LDE) to provide a failover for MLB. During a failover, some data will not be available, and coverage is reduced to boxscore only. After the game is over data entered by Sportradar will be reconciled with the data provided by MLB.
To identify when a live MLB feed has entered failover mode, reference the entry_mode data point in the response. This field indicates how the game data is being collected and is your programmatic indicator for failover status.
For a list of events logged during a failover game, refer to our FAQ page.
Integration Resources
Postman Workspace
Run in PostmanOur full Media API suite—including the MLB collection—lives in our public Postman workspace. Fork or follow any collection to get updates automatically.
Schema Download
Open the zip file below to access our entire MLB API XSD schema.
Simulations
Check out our Simulations to replay actual games at any time, on your own schedule. Simulations for MLB v8 will be available once full coverage 2025 Spring Training games are played.
MCP Server
The Sportradar MLB MCP Server is a Model Context Protocol (MCP) implementation that bridges AI assistants directly to our MLB API feeds. It allows LLMs to use standardized tools to fetch our sports data, helping to power your applications, assist in coding, and streamlining your integration.
For detailed instructions on how to set up and use this integration, visit our MCP Server documentation.
Data Entry Workflow
See below for a daily breakdown of data updates for the MLB API.
Sunday
* Validate game times for today's games (10am CT)
* Game lineups available at least 30 minutes prior to the first pitch
* Game stats validated and moved to `closed` status (within 60 minutes of completion of the game)
* 5-day probables entered and validated (Midnight CT)
* Transactions (All day)\*
* Injury updates (All day)\*\*
* Seasonal stats validation (All day)Monday
* Validate game times for today's games (10am CT)
* Game lineups available at least 30 minutes prior to the first pitch
* Game stats validated and moved to `closed` status (within 60 minutes of completion of the game)
* 5-day probables entered and validated (Midnight CT)
* Transactions (All day)\*
* Injury updates (All day)\*\*
* Seasonal stats validation (All day)Tuesday
* Validate game times for today's games (10am CT)
* Game lineups available at least 30 minutes prior to the first pitch
* Game stats validated and moved to `closed` status (within 60 minutes of completion of the game)
* 5-day probables entered and validated (Midnight CT)
* Transactions (All day)\*
* Injury updates (All day)\*\*
* Seasonal stats validation (All day)Wednesday
* Validate game times for today's games (10am CT)
* Game lineups available at least 30 minutes prior to the first pitch
* Game stats validated and moved to `closed` status (within 60 minutes of completion of the game)
* 5-day probables entered and validated (Midnight CT)
* Transactions (All day)\*
* Injury updates (All day)\*\*
* Seasonal stats validation (All day)Thursday
* Validate game times for today's games (10am CT)
* Game lineups available at least 30 minutes prior to the first pitch
* Game stats validated and moved to `closed` status (within 60 minutes of completion of the game)
* 5-day probables entered and validated (Midnight CT)
* Transactions (All day)\*
* Injury updates (All day)\*\*
* Seasonal stats validation (All day)Friday
* Validate game times for today's games (10am CT)
* Game lineups available at least 30 minutes prior to the first pitch
* Game stats validated and moved to `closed` status (within 60 minutes of completion of the game)
* 5-day probables entered and validated (Midnight CT)
* Transactions (All day)\*
* Injury updates (All day)\*\*
* Seasonal stats validation (All day)Saturday
* Validate game times for today's games (10am CT)
* Game lineups available at least 30 minutes prior to the first pitch
* Game stats validated and moved to `closed` status (within 60 minutes of completion of the game)
* 5-day probables entered and validated (Midnight CT)
* Seasonal stats validation (All day)
* Transactions (All day)\*
* Injury updates (All day)\*\** A transaction is typically updated when an official source, or more than one trusted source, reports it as fact.
** We monitor and update injuries throughout the day during the season and as necessary during the offseason, when an injury may impact the next season. We use official and reliable sources.
Important Dates
* MLB [schedule](https://developer.sportradar.com/baseball/reference/mlb-league-schedule) typically becomes available in September of the previous year. *This release may differ year-to-year depending on seasonal demands.*