---
title: "Standings"
method: POST
path: "/v1/get_standings"
tags: ["Basic lookup"]
---

# Standings

`POST /v1/get_standings`

## Request

- Base URL: `https://mcp.endzoneapi.com`
- URL: `https://mcp.endzoneapi.com/v1/get_standings`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use for regular-season standings and playoff seeding: record, win%, points for/against, home/away/division/conference records, streak, division rank, and conference seed. Ranks apply the real NFL tiebreaking procedure and report which step decided each one. Computed from final scores. Defaults to the current season. Costs 2 credits.

## Request body

- object
  - `season` union: Season year the regular season starts (e.g. 2025). Defaults to current.
    - string
    - number
  - `conference` 'AFC' | 'NFC': Filter by conference
  - `division` string: Filter by division, e.g. 'NFC North'

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `season` number, required
    - `standings` object[], required
      - `team` string, required
      - `name` string, nullable
      - `conference` string, nullable
      - `division` string, nullable
      - `wins` number, required
      - `losses` number, required
      - `ties` number, required
      - `win_pct` number, nullable
      - `points_for` number, nullable
      - `points_against` number, nullable
      - `point_diff` number, nullable
      - `streak` string, nullable
      - `division_rank` number, nullable
      - `conference_rank` number, nullable
      - `division_tiebreaker` string, nullable
      - `conference_tiebreaker` string, nullable
    - `count` number, required
    - `note` string

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

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