season_player_statsnfl.season_player_stats

Season totals for each NFL player — passing, rushing, receiving, defensive, special-teams, and scoring stats accumulated across the year. Regular-season games only; playoff totals are not included.

Full field reference (89 columns) → Data Dictionary Query in GraphQL →

GET/api/v1/nfl/season_player_statsList season_player_stats for NFL

Requires one of: season_id or player_id — requests satisfying none of these return 400.

Parameters

player_idquerybigintoptional

Filter to a single player.

season_idquerybigintoptional

Filter to a season by year (e.g., 2025 for the 2025-26 season). Defaults to the current season.

limitqueryintegeroptionaldefault 100

Page size. Defaults to 100; 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/season_player_stats?season_id=2026'

Responses

200season_player_stats rows matching the declared filter set, wrapped in { season_player_stats, 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(89 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
player_id	bigint		— e.g. 2
season_id	bigint		— e.g. 2025
completion_percentage	decimal	—	— e.g. 0.0000
completions	integer	—	— e.g. 0
defensive_tds	integer	—	— e.g. 0
extra_pts_attempted	integer	—	— e.g. 0
extra_pts_made	integer	—	— e.g. 0
fair_catches	integer	—	— e.g. 0
field_goal_percentage	decimal	—	— e.g. 0.0000
field_goals_attempted	integer	—	— e.g. 0
field_goals_made	integer	—	— e.g. 0
field_goals_made_0_19	integer	—	— e.g. 0
field_goals_made_20_29	integer	—	— e.g. 0
field_goals_made_30_39	integer	—	— e.g. 0
field_goals_made_40_49	integer	—	— e.g. 0
field_goals_made_50_plus	integer	—	— e.g. 0
forced_fumbles	integer	—	— e.g. 0
fumble_return_yds	integer	—	— e.g. 0
fumble_tds	integer	—	— e.g. 0
fumbles	integer	—	— e.g. 0
fumbles_lost	integer	—	— e.g. 0
fumbles_receiving	integer	—	— e.g. 0
fumbles_recovered	integer	—	— e.g. 0
fumbles_rushing	integer	—	— e.g. 0
games_played	integer	—	— e.g. 17
games_started	integer	—	— e.g. 0
interception_return_yds	integer	—	— e.g. 0
interception_tds	integer	—	— e.g. 0
interceptions_defense	integer	—	— e.g. 0
interceptions_thrown	integer	—	— e.g. 0
kick_return_average	decimal	—	— e.g. 0.0000
kick_return_tds	integer	—	— e.g. 0
kick_return_yds	integer	—	— e.g. 0
kick_returns	integer	—	— e.g. 0
longest_field_goal	integer	—	— e.g. 0
longest_kick_return	integer	—	— e.g. 0
longest_punt	integer	—	— e.g. 0
longest_punt_return	integer	—	— e.g. 0
longest_reception	integer	—	— e.g. 0
longest_rush	integer	—	— e.g. 0
pass_attempts	integer	—	— e.g. 0
passer_rating	decimal	—	— e.g. 0.0000
passes_defended	integer	—	— e.g. 0
passing_air_yds	integer	—	Total passing air yards e.g. 0
passing_first_downs	integer	—	Total passing first downs e.g. 0
passing_long	integer	—	Longest pass (season max) e.g. 0
passing_tds	integer	—	— e.g. 0
passing_yds	integer	—	— e.g. 0
passing_yds_after_catch	integer	—	Total YAC from passes e.g. 0
punt_average	decimal	—	— e.g. 0.0000
punt_net_average	decimal	—	— e.g. 0.0000
punt_return_average	decimal	—	— e.g. 0.0000
punt_return_tds	integer	—	— e.g. 0
punt_return_yds	integer	—	— e.g. 0
punt_returns	integer	—	— e.g. 0
punt_touchbacks	integer	—	— e.g. 0
punt_yds	integer	—	— e.g. 0
punts	integer	—	— e.g. 0
punts_blocked	integer	—	— e.g. 0
punts_inside_20	integer	—	— e.g. 0
quarterback_hits	integer	—	— e.g. 0
receiving_air_yds	integer	—	Total receiving air yards e.g. 0
receiving_first_downs	integer	—	Total receiving first downs e.g. 0
receiving_fumbles_lost	integer	—	Total receiving fumbles lost e.g. 0
receiving_tds	integer	—	— e.g. 0
receiving_yds	integer	—	— e.g. 0
receiving_yds_after_catch	integer	—	Total receiving YAC e.g. 0
receptions	integer	—	— e.g. 0
rushing_attempts	integer	—	— e.g. 0
rushing_first_downs	integer	—	Total rushing first downs e.g. 0
rushing_fumbles_lost	integer	—	Total rushing fumbles lost e.g. 0
rushing_tds	integer	—	— e.g. 0
rushing_yds	integer	—	— e.g. 0
sack_fumbles	integer	—	Total fumbles on sacks e.g. 0
sack_fumbles_lost	integer	—	Total sack fumbles lost e.g. 0
sack_yds_lost	integer	—	— e.g. 0
sacks	decimal	—	— e.g. 0.0000
sacks_taken	integer	—	— e.g. 0
safeties	integer	—	— e.g. 0
special_teams_tds	integer	—	Total special teams touchdowns e.g. 0
tackles_assisted	integer	—	— e.g. 0
tackles_for_loss	integer	—	— e.g. 0
tackles_solo	integer	—	— e.g. 0
targets	integer	—	— e.g. 0
total_tackles	integer	—	— e.g. 0
yds_per_attempt	decimal	—	— e.g. 0.0000
yds_per_carry	decimal	—	— e.g. 0.0000
yds_per_reception	decimal	—	— e.g. 0.0000

GET/api/v1/nfl/season_player_stats/{id}Get a single season_player_stat by id

Parameters

idpathbigintrequired

Primary key (id) of the season_player_stat 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/season_player_stats/{pk_value}'

Responses

200Single season_player_stat row.application/jsonshow example ▸

404Row not found.

Response Schema(89 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
player_id	bigint		— e.g. 2
season_id	bigint		— e.g. 2025
completion_percentage	decimal	—	— e.g. 0.0000
completions	integer	—	— e.g. 0
defensive_tds	integer	—	— e.g. 0
extra_pts_attempted	integer	—	— e.g. 0
extra_pts_made	integer	—	— e.g. 0
fair_catches	integer	—	— e.g. 0
field_goal_percentage	decimal	—	— e.g. 0.0000
field_goals_attempted	integer	—	— e.g. 0
field_goals_made	integer	—	— e.g. 0
field_goals_made_0_19	integer	—	— e.g. 0
field_goals_made_20_29	integer	—	— e.g. 0
field_goals_made_30_39	integer	—	— e.g. 0
field_goals_made_40_49	integer	—	— e.g. 0
field_goals_made_50_plus	integer	—	— e.g. 0
forced_fumbles	integer	—	— e.g. 0
fumble_return_yds	integer	—	— e.g. 0
fumble_tds	integer	—	— e.g. 0
fumbles	integer	—	— e.g. 0
fumbles_lost	integer	—	— e.g. 0
fumbles_receiving	integer	—	— e.g. 0
fumbles_recovered	integer	—	— e.g. 0
fumbles_rushing	integer	—	— e.g. 0
games_played	integer	—	— e.g. 17
games_started	integer	—	— e.g. 0
interception_return_yds	integer	—	— e.g. 0
interception_tds	integer	—	— e.g. 0
interceptions_defense	integer	—	— e.g. 0
interceptions_thrown	integer	—	— e.g. 0
kick_return_average	decimal	—	— e.g. 0.0000
kick_return_tds	integer	—	— e.g. 0
kick_return_yds	integer	—	— e.g. 0
kick_returns	integer	—	— e.g. 0
longest_field_goal	integer	—	— e.g. 0
longest_kick_return	integer	—	— e.g. 0
longest_punt	integer	—	— e.g. 0
longest_punt_return	integer	—	— e.g. 0
longest_reception	integer	—	— e.g. 0
longest_rush	integer	—	— e.g. 0
pass_attempts	integer	—	— e.g. 0
passer_rating	decimal	—	— e.g. 0.0000
passes_defended	integer	—	— e.g. 0
passing_air_yds	integer	—	Total passing air yards e.g. 0
passing_first_downs	integer	—	Total passing first downs e.g. 0
passing_long	integer	—	Longest pass (season max) e.g. 0
passing_tds	integer	—	— e.g. 0
passing_yds	integer	—	— e.g. 0
passing_yds_after_catch	integer	—	Total YAC from passes e.g. 0
punt_average	decimal	—	— e.g. 0.0000
punt_net_average	decimal	—	— e.g. 0.0000
punt_return_average	decimal	—	— e.g. 0.0000
punt_return_tds	integer	—	— e.g. 0
punt_return_yds	integer	—	— e.g. 0
punt_returns	integer	—	— e.g. 0
punt_touchbacks	integer	—	— e.g. 0
punt_yds	integer	—	— e.g. 0
punts	integer	—	— e.g. 0
punts_blocked	integer	—	— e.g. 0
punts_inside_20	integer	—	— e.g. 0
quarterback_hits	integer	—	— e.g. 0
receiving_air_yds	integer	—	Total receiving air yards e.g. 0
receiving_first_downs	integer	—	Total receiving first downs e.g. 0
receiving_fumbles_lost	integer	—	Total receiving fumbles lost e.g. 0
receiving_tds	integer	—	— e.g. 0
receiving_yds	integer	—	— e.g. 0
receiving_yds_after_catch	integer	—	Total receiving YAC e.g. 0
receptions	integer	—	— e.g. 0
rushing_attempts	integer	—	— e.g. 0
rushing_first_downs	integer	—	Total rushing first downs e.g. 0
rushing_fumbles_lost	integer	—	Total rushing fumbles lost e.g. 0
rushing_tds	integer	—	— e.g. 0
rushing_yds	integer	—	— e.g. 0
sack_fumbles	integer	—	Total fumbles on sacks e.g. 0
sack_fumbles_lost	integer	—	Total sack fumbles lost e.g. 0
sack_yds_lost	integer	—	— e.g. 0
sacks	decimal	—	— e.g. 0.0000
sacks_taken	integer	—	— e.g. 0
safeties	integer	—	— e.g. 0
special_teams_tds	integer	—	Total special teams touchdowns e.g. 0
tackles_assisted	integer	—	— e.g. 0
tackles_for_loss	integer	—	— e.g. 0
tackles_solo	integer	—	— e.g. 0
targets	integer	—	— e.g. 0
total_tackles	integer	—	— e.g. 0
yds_per_attempt	decimal	—	— e.g. 0.0000
yds_per_carry	decimal	—	— e.g. 0.0000
yds_per_reception	decimal	—	— e.g. 0.0000