Skip to content

get_depth_chart

2 creditsBasic lookupPOST /v1/get_depth_chart

Data refreshed · changelog

Team depth chart by week

Use it when you need who starts where: formation, position, and depth rank for a team and week.

Parameters

teamstringrequired
Team code
seasonstring | numberoptional
Season year. Defaults to current.
weekintegeroptional
Week. Defaults to latest.
formationstringoptional
Filter by formation/unit, e.g. Offense, Defense, Special Teams

Notes

  • Over MCP, ask for it in plain English and the client calls get_depth_chart itself. Point any MCP client at https://mcp.endzoneapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 2 credits, taken before it runs and refunded if the server errors.
  • Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.endzoneapi.com/v1/get_depth_chart \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "team": "KC",
  "season": 2025,
  "week": 9,
  "formation": "Offense"
}'

Response

json
{
  "team": "KC",
  "season": 2025,
  "week": 9,
  "depth_chart": [
    {
      "formation": "3WR 1TE",
      "position": "C",
      "depth_rank": 1,
      "player_id": "00-0036623",
      "name": "Creed Humphrey",
      "jersey_number": null,
      "snapshot_at": "2025-11-02T07:13:47.000Z"
    },
    {
      "formation": "3WR 1TE",
      "position": "C",
      "depth_rank": 2,
      "player_id": "00-0039827",
      "name": "Hunter Nourzad",
      "jersey_number": null,
      "snapshot_at": "2025-11-02T07:13:47.000Z"
    },
    {
      "formation": "3WR 1TE",
      "position": "C",
      "depth_rank": 3,
      "player_id": "00-0037207",
      "name": "Mike Caliendo",
      "jersey_number": null,
      "snapshot_at": "2025-11-02T07:13:47.000Z"
    }
  ],
  "count": 37
}

Response fields

teamstring
seasonnumber
weeknumber
depth_chart[]array
List of objects
depth_chart[].formationstring
depth_chart[].positionstring
depth_chart[].depth_ranknumber
depth_chart[].player_idstring
depth_chart[].namestring
depth_chart[].jersey_numbernull
depth_chart[].snapshot_atstring
countnumber

Related endpoints

Try it

500 free credits every month: 250 calls to get_depth_chart, and no card.