---
title: "Get an MLB game feed"
method: GET
path: "/mlb/game"
tags: ["MLB"]
---

# Get an MLB game feed

`GET /mlb/game`

## Request

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

Returns an MLB game summary by numeric `id`. The response has the status, both teams with records and score, inning-by-inning runs, probable pitchers, winning, losing and save pitchers, and team box-score totals. It does not include the full play-by-play. Use the play-by-play endpoint for that.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MlbGameResponseDoc
  - `code` integer
  - `data` MlbGameResponse
    - `away_boxscore` MlbTeamBoxscore
      - `batters` integer[]
      - `pitchers` integer[]
      - `players_used` 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.
      - `team_stats` object
    - `decisions` MlbDecision
      - `loser` MlbNamedRef
        - `id` integer: MLB id of the player or league.
        - `name` string: Name of the player or league.
      - `save` MlbNamedRef
        - `id` integer: MLB id of the player or league.
        - `name` string: Name of the player or league.
      - `winner` MlbNamedRef
        - `id` integer: MLB id of the player or league.
        - `name` string: Name of the player or league.
    - `fetched_at` string
    - `game` 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
    - `home_boxscore` MlbTeamBoxscore
      - `batters` integer[]
      - `pitchers` integer[]
      - `players_used` 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.
      - `team_stats` object
    - `linescore` MlbLinescore
      - `away_errors` integer
      - `away_hits` integer
      - `away_runs` integer
      - `current_inning` integer
      - `home_errors` integer
      - `home_hits` integer
      - `home_runs` integer
      - `inning_state` string
      - `innings` MlbInning[]
        - `away_errors` integer
        - `away_hits` integer
        - `away_runs` integer
        - `home_errors` integer
        - `home_hits` integer
        - `home_runs` integer
        - `number` integer
      - `scheduled_innings` integer
    - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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)