STAT-API

NBA team_standings API

team_standingsnba.team_standings
Conference and division standings throughout the NBA season — wins, losses, win percentage, games behind, last-10 record, win/loss streak, and home/away splits as of each date.
Full field reference (21 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/nba/team_standings
Requires one of: season_id — requests satisfying none of these return 400.
Parameters
season_idquerybigintoptional
Filter to a single season. Defaults to the current season.
team_idquerybigintoptional
Filter by team.
dayqueryintegeroptional
Standings as of this day (YYYYMMDD integer). Omit for all daily snapshots, newest first; pass a day for a point-in-time table. Range syntax: day__gte=, day__lte=, day__between=.
limitqueryintegeroptionaldefault 100
Page size. Defaults to 100; max 5000.
from_idquerybigintoptional
Return rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nba/team_standings?season_id=2026'
Responses
200team_standings rows matching the declared filter set, wrapped in { team_standings, limit, next_from_id }. next_from_id is the last row's id on a full page — pass it back via ?from_id= to walk the full result; null marks the terminal page.application/jsonshow example ▸
400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.application/json
Response Schema(21 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
season_id
bigint—
e.g. 2024
team_id
bigint—
e.g. 1
away_losses
integer——
e.g. 6
away_wins
integer——
e.g. 1
conference_gb
decimal—Games back from conference leader
e.g. 0.0000
conference_rank
integer—1-15 within conference
e.g. 8
day
integer—YYYYMMDD — standings as of this date (before games on this day)
e.g. 20241103
division_rank
integer—1-5 within division
e.g. 1
games_played
integer——
e.g. 1
games_remaining
integer——
e.g. 81
home_losses
integer——
e.g. 4
home_wins
integer——
e.g. 1
l10_losses
integer——
e.g. 4
l10_wins
integer——
e.g. 6
losses
integer——
e.g. 1
playin_gb
decimal—Games back from 10th seed (play-in cutoff)
e.g. 0.0000
playoff_gb
decimal—Games back from 6th seed (auto-qualify cutoff)
e.g. 0.0000
streak
integer—Positive = win streak, negative = loss streak
e.g. -1
win_pct
decimal——
e.g. 0.5000
wins
integer——
e.g. 2
GET/api/v1/nba/team_standings/{id}
Parameters
idpathbigintrequired
Primary key (id) of the team_standing row.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nba/team_standings/{pk_value}'
Responses
200Single team_standing row.application/jsonshow example ▸
404Row not found.
Response Schema(21 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
season_id
bigint—
e.g. 2024
team_id
bigint—
e.g. 1
away_losses
integer——
e.g. 6
away_wins
integer——
e.g. 1
conference_gb
decimal—Games back from conference leader
e.g. 0.0000
conference_rank
integer—1-15 within conference
e.g. 8
day
integer—YYYYMMDD — standings as of this date (before games on this day)
e.g. 20241103
division_rank
integer—1-5 within division
e.g. 1
games_played
integer——
e.g. 1
games_remaining
integer——
e.g. 81
home_losses
integer——
e.g. 4
home_wins
integer——
e.g. 1
l10_losses
integer——
e.g. 4
l10_wins
integer——
e.g. 6
losses
integer——
e.g. 1
playin_gb
decimal—Games back from 10th seed (play-in cutoff)
e.g. 0.0000
playoff_gb
decimal—Games back from 6th seed (auto-qualify cutoff)
e.g. 0.0000
streak
integer—Positive = win streak, negative = loss streak
e.g. -1
win_pct
decimal——
e.g. 0.5000
wins
integer——
e.g. 2