---
title: "NBA box-score derived season metrics"
method: GET
path: "/v1/nba/players/{id}/season"
tags: ["nba", "players"]
---

# NBA box-score derived season metrics

`GET /v1/nba/players/{id}/season`

## Request

- Base URL: `https://api.bigballsdata.com`
- URL: `https://api.bigballsdata.com/v1/nba/players/{id}/season`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Most recent season with stored game box scores. Includes basic
per-game averages and advanced shooting and usage metrics. The result
can differ in the last decimal from /season-averages, which serves a
separate stored feed. A known NBA player with no box-score rows gets
200 with `season=null`, `games_played=0`, `basic=null` and
`advanced=null`. Available on Free with basketball entitlement.

## Path parameters

- `id` string, uuid, required

## Response `200`

NBA season basic and advanced values, or an explicit no-games response.

- object
  - `data` object, required
    - `player` object, required
      - `id` string, uuid
      - `name` string
      - `position` string, nullable
      - `headshot_url` string, nullable
      - `team` object
    - `season` integer, nullable, required
    - `games_played` integer, required
    - `basic` object, nullable, required
      - `ppg` number, nullable
      - `rpg` number, nullable
      - `apg` number, nullable
      - `spg` number, nullable
      - `bpg` number, nullable
      - `mpg` number, nullable
      - `fg_pct` number, nullable
      - `fg3_pct` number, nullable
      - `ft_pct` number, nullable
    - `advanced` object, nullable, required
      - `true_shooting_pct` number, nullable
      - `efg_pct` number, nullable
      - `usage_rate` number, nullable
      - `per` number, nullable
      - `per_status` 'computed' | 'pending_validation'
    - `as_of` string, date-time, required
  - `meta` object, required
    - `cached` boolean
    - `cache_age_ms` integer

## Other responses

- `400`: Invalid player id.
- `403`: The key does not include basketball.
- `404`: No NBA player with that id.

---

[API](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api.md) · [All operations](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/revisions/31fb54ac414e?raw)