---
title: "NFL depth chart changes (Growth+)"
method: GET
path: "/v1/nfl/depth-chart/changes"
tags: ["NFL"]
---

# NFL depth chart changes (Growth+)

`GET /v1/nfl/depth-chart/changes`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/nfl/depth-chart/changes`
- Auth: API key in header `X-PlayCaller-Key`

Training camp and in-season depth chart moves detected from Sleeper daily snapshots. Includes AI-generated blurbs explaining fantasy impact. Active Jul 20–Feb; returns empty array off-season.

**Tier access:** Growth, Pro Insights, Syndicate Alpha

## Query parameters

- `since` string, date
- `team` string
- `position` 'QB' | 'RB' | 'WR' | 'TE'
- `change_type` 'promoted' | 'demoted' | 'added' | 'removed'
- `limit` integer

## Response `200`

Depth chart changes

- object
  - `success` boolean
  - `endpoint` string
  - `sport` string
  - `since` string, date
  - `count` integer
  - `data` object[]
    - `id` integer
    - `team` string
    - `position` string
    - `player_name` string
    - `player_id` string
    - `old_order` integer, nullable
    - `new_order` integer, nullable
    - `change_type` 'promoted' | 'demoted' | 'added' | 'removed'
    - `ai_blurb` string, nullable
    - `detected_date` string, date
    - `created_at` string, date-time
  - `meta` ResponseMeta
    - `sport` string
    - `league` string: Present on multi-sport (ESPN-backed) endpoints; mirrors sport unless a sport has sub-leagues (e.g. soccer: epl/mls).
    - `tier` string
    - `calls_remaining_this_month` integer
    - `documentation_url` string, uri

## Other responses

- `401`: Missing or invalid API key
- `402`: Growth tier or higher required
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)
