---
title: "Get the MLB schedule and scores"
method: GET
path: "/mlb/schedule"
tags: ["MLB"]
---

# Get the MLB schedule and scores

`GET /mlb/schedule`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/mlb/schedule`
- Auth: API key in header `x-api-key`

Returns MLB games, teams, scores, status, probable pitchers, venue, and series information for one date or date range, optionally filtered to a team.

## Query parameters

- `date` string
- `start_date` string
- `end_date` string
- `team_id` string
- `game_type` 'S' | 'R' | 'F' | 'D' | 'L' | 'W' | 'C' | 'P' | 'A' | 'I' | 'E'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MlbScheduleResponseDoc
  - `code` integer
  - `data` MlbScheduleResponse
    - `date` string
    - `end_date` string
    - `fetched_at` string
    - `games` MlbGameSummary[]
      - `away` MlbGameSide
        - `losses` integer
        - `probable_pitcher` MlbNamedRef
          - `id` integer: MLB id of the player or league.
          - `name` string: Name of the player or league.
        - `score` integer
        - `team` MlbTeamRef
          - `abbreviation` string: Short team abbreviation, for example `NYY`. Omitted when not available.
          - `id` integer: MLB team id.
          - `name` string: Full team name.
        - `wins` integer
      - `day_night` string
      - `double_header` string
      - `game_date` string
      - `game_number` integer
      - `game_type` string
      - `home` MlbGameSide
        - `losses` integer
        - `probable_pitcher` MlbNamedRef
          - `id` integer: MLB id of the player or league.
          - `name` string: Name of the player or league.
        - `score` integer
        - `team` MlbTeamRef
          - `abbreviation` string: Short team abbreviation, for example `NYY`. Omitted when not available.
          - `id` integer: MLB team id.
          - `name` string: Full team name.
        - `wins` integer
      - `id` integer
      - `official_date` string
      - `scheduled_innings` integer
      - `season` string
      - `series_description` string
      - `status` MlbGameStatus
        - `abstract` string
        - `code` string
        - `detailed` string
        - `reason` string
      - `venue` MlbVenueRef
        - `id` integer
        - `name` string
    - `source_url` string
    - `start_date` string
    - `team_id` integer
    - `total_games` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)