---
title: "List team_standings for NBA"
method: GET
path: "/api/v1/nba/team_standings"
tags: ["NBA"]
---

# List team_standings for NBA

`GET /api/v1/nba/team_standings`

## Request

- Base URL: `https://api.stat-api.com`
- URL: `https://api.stat-api.com/api/v1/nba/team_standings`
- Auth: HTTP bearer

## Query parameters

- `season_id` integer
- `team_id` integer
- `day` integer
- `day__gte` integer
- `day__lte` integer
- `day__between` integer
- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

team_standings rows matching the declared filter set.

- NBATeamStandingsListResponse
  - `has_more` boolean, required: True when a full page came back, so more rows can exist.
  - `limit` integer, required: Page size used for this response.
  - `next_from_id` integer, nullable, required: Pass this as `from_id` on the next request to page forward. `null` on the terminal page, and on a first page requested without `from_id` (that page uses the default sort): to walk every row, start with `from_id=0`.
  - `team_standings` NBATeamStandings[], required
    - `away_losses` integer, required
    - `away_wins` integer, required
    - `conference_gb` number, double, required: Games back from conference leader
    - `conference_rank` integer, required: 1-15 within conference
    - `day` integer, required: YYYYMMDD — standings as of this date (before games on this day)
    - `division_rank` integer, required: 1-5 within division
    - `games_played` integer, required
    - `games_remaining` integer, required
    - `home_losses` integer, required
    - `home_wins` integer, required
    - `id` integer, required: Primary Key
    - `l10_losses` integer, required
    - `l10_wins` integer, required
    - `losses` integer, required
    - `playin_gb` number, double, required: Games back from 10th seed (play-in cutoff)
    - `playoff_gb` number, double, required: Games back from 6th seed (auto-qualify cutoff)
    - `season_id` integer, required
    - `streak` integer, required: Positive = win streak, negative = loss streak
    - `team_id` integer, required
    - `win_pct` number, double, required
    - `wins` integer, required

## Other responses

- `400`: No declared filter set was satisfied by the request — see `accepted` in the body for the valid combinations.

---

[API](https://skmtc.dev/stat-api/apis/sports-db-public-api.md) · [All operations](https://skmtc.dev/stat-api/apis/sports-db-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stat-api/apis/sports-db-public-api/revisions/23b66b957723?raw)