MLB

Live and scheduled MLB games

Live inning-by-inning game state from the MLB Stats API pipeline. Defaults to today's games. Scores update on a polling cycle throughout the game day.

Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha

get/v1/mlb/games

Request

  • Base URL: https://api.playcallerapp.com
  • URL: https://api.playcallerapp.com/v1/mlb/games
  • Auth: API key in header X-PlayCaller-Key

Query parameters

datestring date

Game date (YYYY-MM-DD, defaults to today)

state'pre_game' | 'scheduled' | 'in_progress' | 'final' | 'completed' | 'postponed'

Filter by game state (matches the live state column exactly)

limitinteger

Max games (default 30, max 100)

Response

MLB game states

successboolean
endpointstring
countinteger

Example response

{
  "data": [
    {
      "game_pk": "745302",
      "game_date": "2026-05-01T00:00:00.000Z",
      "game_time": "2026-05-01T22:10:00.000Z",
      "state": "completed",
      "home_team": {
        "id": 146,
        "name": "Miami Marlins",
        "score": 4
      },
      "away_team": {
        "id": 140,
        "name": "Texas Rangers",
        "score": 2
      },
      "inning": 9,
      "inning_state": "Top",
      "is_final": true,
      "status_code": "F",
      "last_polled": "2026-05-01T22:14:05Z"
    }
  ],
  "meta": {
    "sport": "nfl",
    "league": "nfl",
    "tier": "pro",
    "calls_remaining_this_month": 9843,
    "documentation_url": "https://playcallerapp.com/developer/docs"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.