---
title: "NBA conference standings"
method: GET
path: "/v1/nba/standings"
tags: ["NBA"]
---

# NBA conference standings

`GET /v1/nba/standings`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/nba/standings`
- Auth: API key in header `X-PlayCaller-Key`

Current NBA standings including conference, division, win %, streak, and home/away split records. Filterable by conference.

**Tier access:** Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha

## Query parameters

- `season` integer
- `conference` 'East' | 'West'

## Response `200`

NBA standings by conference

- object
  - `success` boolean
  - `endpoint` string
  - `season` integer
  - `count` integer
  - `data` ESPNStanding[]
    - `rank` integer
    - `league` string, nullable: Soccer only (epl/mls)
    - `ties` integer, nullable: Soccer only — NBA/CFB have no tie record
    - `team_id` string
    - `team_name` string
    - `team_abbr` string
    - `team_logo` string, uri, nullable
    - `conference` string, nullable
    - `division` string, nullable
    - `wins` integer
    - `losses` integer
    - `win_pct` number, float
    - `games_back` string, nullable
    - `streak` string, nullable
    - `home_record` string, nullable
    - `away_record` string, nullable
    - `conf_record` string, nullable
    - `points_for` number, float, nullable
    - `points_against` number, float, nullable
    - `last_updated` string, date-time, nullable
  - `meta` ResponseMeta
    - `sport` string
    - `league` string: Present on multi-sport (ESPN-backed) endpoints; mirrors sport unless a sport has sub-leagues (e.g. soccer: epl/mls).
    - `tier` string
    - `calls_remaining_this_month` integer
    - `documentation_url` string, uri

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)