---
title: "ESPN standings"
method: GET
path: "/espn/standings"
tags: ["ESPN"]
---

# ESPN standings

`GET /espn/standings`

## Request

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

Returns league standings grouped by conference/division. The `sport` enum accepts `football`, `basketball`, `baseball`, `hockey`, and `soccer`. The `league` enum accepts `nfl`, `college-football`, `nba`, `wnba`, `mens-college-basketball`, `womens-college-basketball`, `mlb`, `nhl`, `eng.1`, `esp.1`, `ita.1`, `ger.1`, `fra.1`, `usa.1`, and `uefa.champions`; it must be valid for the chosen sport. The `seasontype` enum accepts `1` (preseason), `2` (regular season), and `3` (postseason).

## Query parameters

- `sport` 'football' | 'basketball' | 'baseball' | 'hockey' | 'soccer', required
- `league` 'nfl' | 'college-football' | 'nba' | 'wnba' | 'mens-college-basketball' | 'womens-college-basketball' | 'mlb' | 'nhl' | 'eng.1' | 'esp.1' | 'ita.1' | 'ger.1' | 'fra.1' | 'usa.1' | 'uefa.champions', required
- `season` integer
- `seasontype` 1 | 2 | 3

## Headers

- `x-api-key` string, required

## Response `200`

OK

- EspnStandingsResponseDoc
  - `code` integer
  - `data` EspnStandingsResponse
    - `fetched_at` string
    - `groups` EspnStandingsGroup[]
      - `abbreviation` string
      - `entries` EspnStandingsEntry[]
        - `note` string
        - `stats` object
        - `team` EspnTeamRef
          - `abbreviation` string: Short team code, for example `KC`.
          - `alternate_color` string: Team's secondary colour code, as ESPN gives it.
          - `color` string: Team's primary colour code, as ESPN gives it.
          - `display_name` string: Full team name, for example `Kansas City Chiefs`.
          - `id` string: ESPN team id, for example `12`. Use it as the `team` parameter of the team and roster endpoints.
          - `location` string: Team's city or region, for example `Kansas City`.
          - `logo` string: URL of the team logo image.
          - `name` string: Team nickname without the location, for example `Chiefs`.
          - `short_display_name` string: Shortened team name, for example `Chiefs`.
          - `uid` string: ESPN's unique identifier string for the team.
      - `name` string
    - `league` string
    - `league_name` string
    - `season` EspnSeason
      - `name` string: Season type name as ESPN shows it.
      - `type` integer: Season type code: 1 preseason, 2 regular season, 3 postseason, 4 offseason.
      - `year` integer: Season year, for example `2024`.
    - `source_url` string
    - `sport` 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/afac9b012a27?raw)