Skip to main content

​
Introduction

The MLB Stats API is a comprehensive REST API that provides access to real-time and historical baseball data including:
  • Game schedules and live scores
  • Player statistics and biographical information
  • Team rosters and standings
  • Play-by-play data and win probability
  • Transactions, draft results, and historical records
This application provides TypeScript functions that simplify fetching data from the MLB Stats API.

​
Base URL

All API requests are made to the MLB Stats API base URL: 
const HOST = 'https://statsapi.mlb.com'
Endpoints are relative to this base URL. For example:
  • /api/v1/schedule becomes https://statsapi.mlb.com/api/v1/schedule
  • /api/v1.1/game/{gamePk}/feed/live becomes https://statsapi.mlb.com/api/v1.1/game/813024/feed/live

​
Authentication

The MLB Stats API is publicly accessible and does not require authentication or API keys. All endpoints can be accessed without credentials.
While no authentication is required, be mindful of rate limits and avoid excessive requests that could impact API availability.

​
API Versioning

The API uses URL-based versioning:
  • v1 - Most endpoints use /api/v1/
  • v1.1 - Live game feeds use /api/v1.1/ for enhanced real-time data

​
Query Parameters

Most endpoints support filtering and customization through query parameters:

​
Common Parameters

​
sportId
string
default:"1"
Sport identifier. 1 = MLB, 11 = AAA, 51 = International
​
season
string
Year for seasonal data (e.g., "2025")
​
fields
string | string[]
Comma-separated field paths to include in response. Reduces payload size by returning only requested fields.Example: "dates,games,gamePk,teams,team,name"
​
hydrate
string
Additional data to include in response. Common values: "team", "person", "linescore"

​
Date Parameters

​
date
string
Specific date in ISO format: "2026-03-26"
​
startDate
string
Start of date range in ISO format
​
endDate
string
End of date range in ISO format

​
Response Format

All API responses are in JSON format. The structure varies by endpoint but typically includes: 
{
  "copyright": "Copyright notice",
  "data": {
    // Endpoint-specific data
  }
}

​
Common Entity IDs

Many endpoints require specific entity IDs:

​
Sport IDs

  • 1 - Major League Baseball (MLB)
  • 11 - Triple-A (AAA)
  • 51 - International Baseball

​
League IDs

  • 103 - American League (AL)
  • 104 - National League (NL)

​
Team IDs (Examples)

  • 119 - Los Angeles Dodgers
  • 147 - New York Yankees

​
Game Types

  • R - Regular Season
  • S - Spring Training
  • P - Playoffs
  • W - World Series
Use the API Playground to explore endpoints and discover entity IDs interactively.

​
Next Steps

Try the Playground

Explore API endpoints interactively and see live responses

Browse Endpoints

View all available MLB Stats API endpoints

Use Fetch Library

Learn how to fetch data in your TypeScript code

Preset Functions

Use pre-configured functions for common queries

Build docs developers (and LLMs) love

Get started for freeTalk to us