---
title: "Get MLB standings"
method: GET
path: "/mlb/standings"
tags: ["MLB"]
---

# Get MLB standings

`GET /mlb/standings`

## Request

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

Returns American League and National League standings, including source-provided expected, home/away, last-ten, ranking, and elimination fields when available, using any supported standings type returned by mlb_discovery.

## Query parameters

- `season` integer
- `type` 'regularSeason' | 'wildCard' | 'divisionLeaders' | 'wildCardWithLeaders' | 'firstHalf' | 'secondHalf' | 'springTraining' | 'postseason' | 'byDivision' | 'byConference' | 'byLeague' | 'byOrganization' | 'currentHalf'
- `date` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MlbStandingsResponseDoc
  - `code` integer
  - `data` MlbStandingsResponse
    - `date` string
    - `fetched_at` string
    - `groups` MlbStandingsGroup[]
      - `division` MlbNamedRef
        - `id` integer: MLB id of the player or league.
        - `name` string: Name of the player or league.
      - `league` MlbNamedRef
        - `id` integer: MLB id of the player or league.
        - `name` string: Name of the player or league.
      - `teams` MlbStandingsTeam[]
        - `away_record` MlbRecord
          - `losses` integer
          - `pct` string
          - `wins` integer
        - `clinched` boolean
        - `division_leader` boolean
        - `division_rank` string
        - `elimination_number` string
        - `expected_record` MlbRecord
          - `losses` integer
          - `pct` string
          - `wins` integer
        - `games_back` string
        - `games_played` integer
        - `home_record` MlbRecord
          - `losses` integer
          - `pct` string
          - `wins` integer
        - `last_ten_record` MlbRecord
          - `losses` integer
          - `pct` string
          - `wins` integer
        - `league_rank` string
        - `losses` integer
        - `magic_number` string
        - `run_differential` integer
        - `runs_allowed` integer
        - `runs_scored` integer
        - `streak` string
        - `team` MlbTeamRef
          - `abbreviation` string: Short team abbreviation, for example `NYY`. Omitted when not available.
          - `id` integer: MLB team id.
          - `name` string: Full team name.
        - `wild_card_games_back` string
        - `winning_percentage` string
        - `wins` integer
      - `type` string
    - `season` integer
    - `source_url` string
    - `type` string
  - `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/0497899e2016?raw)