---
title: "List depth_charts for NFL"
method: GET
path: "/api/v1/nfl/depth_charts"
tags: ["NFL"]
---

# List depth_charts for NFL

`GET /api/v1/nfl/depth_charts`

## Request

- Base URL: `https://api.stat-api.com`
- URL: `https://api.stat-api.com/api/v1/nfl/depth_charts`
- Auth: HTTP bearer

## Query parameters

- `game_id` integer
- `team_id` integer
- `season_id` integer
- `week` integer
- `player_id` integer
- `position` 'C' | 'CB' | 'DB' | 'DE' | 'DL' | 'DT' | 'FB' | 'FS' | 'G' | 'ILB' | 'K' | 'LB' | 'LS' | 'MLB' | 'NT' | 'OLB' | 'P' | 'QB' | 'RB' | 'S' | 'SAF' | 'SS' | 'T' | 'TE' | 'WR'
- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

depth_charts rows matching the declared filter set.

- NFLDepthChartsListResponse
  - `depth_charts` NFLDepthCharts[], required
    - `depth_order` integer, nullable: Depth-chart rank at this position — 1 for the starter, 2 for the primary backup, etc. NFL depth charts typically run 1–5 deep at each position.
    - `depth_position` string, required: Position slot on the depth chart, which can differ from the player's primary position when they're listed at a secondary position (e.g., a player whose primary position is T may also appear on the depth chart at G).
    - `depth_team` string, nullable: Sub-team designation within the depth chart when present (e.g., a formation-specific team grouping). Sparse — typically NULL.
    - `formation` string, nullable: Formation unit this slot belongs to (e.g., OFF, DEF, ST). Sparse — typically NULL.
    - `game_id` integer, required: FK to nfl.games — the game this depth chart is associated with.
    - `game_type` string, required: Phase of the season: REG (regular season), WC (Wild Card), DIV (Divisional), CON (Conference Championship), SB (Super Bowl).
    - `id` integer, required: Primary Key
    - `jersey_number` integer, nullable: Player's jersey number on the team for this game (nullable — populated when the depth chart includes uniform numbers).
    - `player_id` integer, required: FK to nfl.players — the player occupying this depth-chart slot.
    - `position` string, required: Player's listed position abbreviation (e.g., QB, RB, WR, T, DT, CB, MLB, K, P).
    - `season_id` integer, required: FK to nfl.seasons — the season containing this game.
    - `status` string, nullable: NFL roster status code at the time of the chart: ACT (active), DEV (practice squad / developmental), INA (inactive), RES (reserve / IR), EXE (exempt), CUT (released), TRC (traded — pending), TRD (traded), RET (retired), E01 (other transactional status).
    - `team_id` integer, required: FK to nfl.teams — the team whose depth chart this row belongs to.
    - `week` integer, required: NFL week number within the season (1-18 regular season; postseason weeks use higher numbers per league convention).
  - `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`.

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