---
title: "Player stats"
method: POST
path: "/v1/get_player_stats"
tags: ["Stats + aggregation"]
---

# Player stats

`POST /v1/get_player_stats`

## Request

- Base URL: `https://mcp.endzoneapi.com`
- URL: `https://mcp.endzoneapi.com/v1/get_player_stats`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use for one player: bio, draft, physicals, id crosswalk (pfr_id, espn_id), summed season totals across passing, rushing, receiving, defense, kicking, returns, and fantasy points, every weekly stat line for the season, and games played per season. Defaults to the player's latest season. Costs 5 credits.

## Request body

- object
  - `player_id` string, required: GSIS player id from search_players (e.g. 00-0033873)
  - `season` union: Season year. Defaults to the player's latest season.
    - string
    - number
  - `season_type` 'REG' | 'POST': Regular season (default) or postseason

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `player` object, required
    - `season` number, required
    - `season_type` string, required
    - `season_totals` object, required
    - `weeks` object[], required
    - `seasons` object[], required
    - `count` number, required

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

[API](https://skmtc.dev/endzoneapi/apis/endzoneapi-api.md) · [All operations](https://skmtc.dev/endzoneapi/apis/endzoneapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/endzoneapi/apis/endzoneapi-api/revisions/79ac6ebe298d?raw)