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

# List projected_player_snaps for NFL

`GET /api/v1/nfl/projected_player_snaps`

## Request

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

## Query parameters

- `game_id` integer
- `player_id` integer
- `team_id` integer
- `season_id` integer
- `week` integer
- `position` string
- `mode` 'pre' | 'full'
- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

projected_player_snaps rows matching the declared filter set.

- NFLProjectedPlayerSnapsListResponse
  - `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.
  - `mode` 'pre' | 'full', required: The time-wall mode that served these rows (`pre` or `full`).
  - `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`.
  - `projected_player_snaps` NFLProjectedPlayerSnaps[], required
    - `actual_pass_attempts` integer, nullable: Realized post-game actual pass attempts.
    - `actual_pass_completions` integer, nullable: Realized post-game actual pass completions.
    - `actual_receptions` integer, nullable: Realized post-game actual pass receptions.
    - `actual_rush_attempts` integer, nullable: Realized post-game actual rushing attempts.
    - `actual_snap_share` number, double, nullable: Realized post-game actual snap share percentage.
    - `actual_snaps` integer, nullable: Realized post-game actual offensive snaps played.
    - `actual_targets` integer, nullable: Realized post-game actual receiving targets.
    - `actual_team_snaps` integer, nullable: Realized post-game actual total team offensive snaps.
    - `as_of` string, date-time, required: Point in time the projection reflects (UTC). Set when the projection is published; a backfilled row is never later than its write time.
    - `depth_order` integer, nullable: Official pre-game depth chart order (1 = starter, 2 = primary backup).
    - `game_id` integer, required
    - `id` integer, required: Primary Key
    - `is_inactive` boolean, required: True if player was declared inactive prior to kickoff.
    - `is_starter` boolean, required: True if player is designated as the starter at kickoff.
    - `player_id` integer, required
    - `position` string, required: Player position for this matchup (QB, RB, WR, TE, FB, DST).
    - `projected_pass_attempts` number, double, nullable: Pre-kickoff projected pass attempts (QB only).
    - `projected_pass_completions` number, double, nullable: Pre-kickoff projected pass completions (QB only).
    - `projected_receptions` number, double, nullable: Pre-kickoff projected pass receptions.
    - `projected_rush_attempts` number, double, nullable: Pre-kickoff projected rushing attempts.
    - `projected_rush_share` number, double, nullable: Pre-kickoff projected percentage of team rushing attempts.
    - `projected_snap_share` number, double, required: Pre-kickoff projected percentage of team offensive snaps (0.0000 - 1.0000).
    - `projected_snaps` number, double, required: Pre-kickoff projected offensive snaps.
    - `projected_target_share` number, double, nullable: Pre-kickoff projected percentage of team targets.
    - `projected_targets` number, double, nullable: Pre-kickoff projected receiving targets.
    - `projected_team_snaps` number, double, required: Pre-kickoff projected total offensive snaps for the player's team.
    - `rush_attempts_error` number, double, nullable: Calibration error: actual_rush_attempts minus projected_rush_attempts.
    - `season_id` integer, required
    - `snap_error` number, double, nullable: Calibration error: actual_snaps minus projected_snaps.
    - `snap_share_error` number, double, nullable: Calibration error: actual_snap_share minus projected_snap_share.
    - `source` string, required: SOTA model source version (e.g. STAT_API_SOTA).
    - `targets_error` number, double, nullable: Calibration error: actual_targets minus projected_targets.
    - `team_id` integer, required
    - `touch_rate_per_snap` number, double, nullable: Pre-kickoff projected touches (rushes + receptions) per offensive snap.
    - `week` integer, required: NFL regular season week number.

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