STAT-API

NFL game_player_ngs_passings API

game_player_ngs_passingsnfl.game_player_ngs_passings
NFL Next Gen Stats for quarterbacks per game — RFID-tracked passing metrics like time to throw, average depth of target, completed air yards, on-target throw rate, and aggressiveness against tight coverage.
Full field reference (26 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/nfl/game_player_ngs_passings
Requires one of: game_id or player_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
player_idquerybigintoptional
Filter to a single player.
team_idquerybigintoptional
Filter by team.
seasonqueryintegeroptional
Filter by season start year.
weekqueryintegeroptional
Filter by week of the season.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/game_player_ngs_passings?game_id=1'
Responses
200game_player_ngs_passings rows matching the declared filter set, wrapped in { game_player_ngs_passings, limit, next_from_id }. next_from_id is the last row's id on a full page — pass it back via ?from_id= to walk the full result; null marks the terminal page.application/jsonshow example ▸
400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.application/json
Response Schema(26 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 121
player_gsis_id
string—GSIS ID for cross-reference
e.g. 00-0034857
player_id
bigint—
e.g. 689
team_id
bigint—
e.g. 28
aggressiveness
decimalnullable—Percentage of throws into tight windows (defender within 1 yard)
e.g. 16.6667
attempts
integernullable——
e.g. 30
avg_air_distance
decimalnullable—Average ball travel distance on all attempts
e.g. 20.1294
avg_air_yds_differential
decimalnullable—Difference between intended and completed air yards
e.g. -0.8631
avg_air_yds_to_sticks
decimalnullable—Average air yards relative to first down marker
e.g. -3.6553
avg_completed_air_yds
decimalnullable—Average air yards on completed passes
e.g. 7.1294
avg_intended_air_yds
decimalnullable—Average air yards on all pass attempts
e.g. 7.2488
avg_time_to_throw
decimalnullable—Average time from snap to throw (seconds)
e.g. 2.8413
completion_percentage
decimalnullable——
e.g. 66.6667
completion_percentage_above_expectation
decimalnullable—CPOE - Actual completion % minus expected (positive = better than expected)
e.g. 12.5840
completions
integernullable——
e.g. 22
expected_completion_percentage
decimalnullable—Model-predicted completion percentage based on throw difficulty
e.g. 67.4160
interceptions
integernullable——
e.g. 0
max_air_distance
decimalnullable—Maximum ball travel distance
e.g. 42.0642
max_completed_air_distance
decimalnullable—Longest completed pass distance (ball travel)
e.g. 38.0455
pass_tds
integernullable——
e.g. 1
pass_yds
integernullable——
e.g. 235
passer_rating
decimalnullable——
e.g. 158.3333
season
integer——
e.g. 2024
season_type
string—Canonical season phase.
e.g. regular_season
week
integer——
e.g. 3
GET/api/v1/nfl/game_player_ngs_passings/{id}
Parameters
idpathbigintrequired
Primary key (id) of the game_player_ngs_passing row.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/game_player_ngs_passings/{pk_value}'
Responses
200Single game_player_ngs_passing row.application/jsonshow example ▸
404Row not found.
Response Schema(26 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 121
player_gsis_id
string—GSIS ID for cross-reference
e.g. 00-0034857
player_id
bigint—
e.g. 689
team_id
bigint—
e.g. 28
aggressiveness
decimalnullable—Percentage of throws into tight windows (defender within 1 yard)
e.g. 16.6667
attempts
integernullable——
e.g. 30
avg_air_distance
decimalnullable—Average ball travel distance on all attempts
e.g. 20.1294
avg_air_yds_differential
decimalnullable—Difference between intended and completed air yards
e.g. -0.8631
avg_air_yds_to_sticks
decimalnullable—Average air yards relative to first down marker
e.g. -3.6553
avg_completed_air_yds
decimalnullable—Average air yards on completed passes
e.g. 7.1294
avg_intended_air_yds
decimalnullable—Average air yards on all pass attempts
e.g. 7.2488
avg_time_to_throw
decimalnullable—Average time from snap to throw (seconds)
e.g. 2.8413
completion_percentage
decimalnullable——
e.g. 66.6667
completion_percentage_above_expectation
decimalnullable—CPOE - Actual completion % minus expected (positive = better than expected)
e.g. 12.5840
completions
integernullable——
e.g. 22
expected_completion_percentage
decimalnullable—Model-predicted completion percentage based on throw difficulty
e.g. 67.4160
interceptions
integernullable——
e.g. 0
max_air_distance
decimalnullable—Maximum ball travel distance
e.g. 42.0642
max_completed_air_distance
decimalnullable—Longest completed pass distance (ball travel)
e.g. 38.0455
pass_tds
integernullable——
e.g. 1
pass_yds
integernullable——
e.g. 235
passer_rating
decimalnullable——
e.g. 158.3333
season
integer——
e.g. 2024
season_type
string—Canonical season phase.
e.g. regular_season
week
integer——
e.g. 3