---
title: "NFL depth charts, current or as at a past instant"
method: GET
path: "/v1/nfl/depth-charts"
tags: ["nfl"]
---

# NFL depth charts, current or as at a past instant

`GET /v1/nfl/depth-charts`

## Request

- Base URL: `https://api.bigballsdata.com`
- URL: `https://api.bigballsdata.com/v1/nfl/depth-charts`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Interval-shaped depth chart - one row per player per position per contiguous stretch of state. Defaults to the open intervals; pass as_of to read the chart as it stood at that instant. An open interval is one that has not been closed, which is not the same as "today's chart" - no 2026 charts have been published yet, so the open intervals are currently the final 2025 chart. meta.season_covered names the season the rows actually describe and meta.data_as_of their age. Depth charts are available from 2025 only, so this covers one season, not the six carried by the other NFL endpoints.

## Query parameters

- `team` string
- `position` string
- `season` integer
- `player_id` string
- `as_of` string, date-time
- `limit` integer
- `offset` integer

## Response `200`

ok

- object
  - `data` object[]
  - `pagination` object
    - `total` integer
    - `limit` integer
    - `offset` integer
  - `meta` object
    - `as_of` string, date-time, nullable
    - `open_intervals_only` boolean
    - `season_covered` integer, nullable
    - `data_as_of` string, date-time, nullable

---

[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)