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

# List game_player_ngs_receivings for NFL

`GET /api/v1/nfl/game_player_ngs_receivings`

## Request

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

## Query parameters

- `game_id` integer
- `player_id` integer
- `team_id` integer
- `season` integer
- `week` integer
- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

game_player_ngs_receivings rows matching the declared filter set.

- NFLGamePlayerNgsReceivingsListResponse
  - `game_player_ngs_receivings` NFLGamePlayerNgsReceivings[], required
    - `avg_cushion` number, double, nullable: Average distance from nearest defender at snap (yards)
    - `avg_expected_yac` number, double, nullable: Model-predicted YAC based on catch location/defenders
    - `avg_intended_air_yds` number, double, nullable: Average depth of targets
    - `avg_separation` number, double, nullable: Average distance from nearest defender at catch point (yards)
    - `avg_yac` number, double, nullable: Average yards after catch
    - `avg_yac_above_expectation` number, double, nullable: Actual YAC minus expected (positive = creates extra yards)
    - `catch_percentage` number, double, nullable
    - `game_id` integer, required
    - `id` integer, required: Primary Key
    - `percent_share_of_intended_air_yds` number, double, nullable: Percentage of team total intended air yards (deep target share)
    - `player_gsis_id` string, required: GSIS ID for cross-reference
    - `player_id` integer, required
    - `rec_tds` integer, nullable
    - `receptions` integer, nullable
    - `season` integer, required
    - `season_type` string, required: Canonical season phase.
    - `targets` integer, nullable
    - `team_id` integer, required
    - `week` integer, required
    - `yards` integer, nullable
  - `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/601ff9eaca3f?raw)