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

# List season_player_stats for NFL

`GET /api/v1/nfl/season_player_stats`

## Request

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

## Query parameters

- `player_id` integer
- `season_id` integer
- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

season_player_stats rows matching the declared filter set.

- NFLSeasonPlayerStatsListResponse
  - `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`.
  - `season_player_stats` NFLSeasonPlayerStats[], required
    - `completion_percentage` number, double, required
    - `completions` integer, required
    - `defensive_tds` integer, required
    - `extra_pts_attempted` integer, required
    - `extra_pts_made` integer, required
    - `fair_catches` integer, required
    - `field_goal_percentage` number, double, required
    - `field_goals_attempted` integer, required
    - `field_goals_made` integer, required
    - `field_goals_made_0_19` integer, required
    - `field_goals_made_20_29` integer, required
    - `field_goals_made_30_39` integer, required
    - `field_goals_made_40_49` integer, required
    - `field_goals_made_50_plus` integer, required
    - `forced_fumbles` integer, required
    - `fumble_return_yds` integer, required
    - `fumble_tds` integer, required
    - `fumbles` integer, required
    - `fumbles_lost` integer, required
    - `fumbles_receiving` integer, required
    - `fumbles_recovered` integer, required
    - `fumbles_rushing` integer, required
    - `games_played` integer, required
    - `games_started` integer, required
    - `id` integer, required: Primary Key
    - `interception_return_yds` integer, required
    - `interception_tds` integer, required
    - `interceptions_defense` integer, required
    - `interceptions_thrown` integer, required
    - `kick_return_average` number, double, required
    - `kick_return_tds` integer, required
    - `kick_return_yds` integer, required
    - `kick_returns` integer, required
    - `longest_field_goal` integer, required
    - `longest_kick_return` integer, required
    - `longest_punt` integer, required
    - `longest_punt_return` integer, required
    - `longest_reception` integer, required
    - `longest_rush` integer, required
    - `pass_attempts` integer, required
    - `passer_rating` number, double, required
    - `passes_defended` integer, required
    - `passing_air_yds` integer, required: Total passing air yards
    - `passing_first_downs` integer, required: Total passing first downs
    - `passing_long` integer, required: Longest pass (season max)
    - `passing_tds` integer, required
    - `passing_yds` integer, required
    - `passing_yds_after_catch` integer, required: Total YAC from passes
    - `player_id` integer, required
    - `punt_average` number, double, required
    - `punt_net_average` number, double, required
    - `punt_return_average` number, double, required
    - `punt_return_tds` integer, required
    - `punt_return_yds` integer, required
    - `punt_returns` integer, required
    - `punt_touchbacks` integer, required
    - `punt_yds` integer, required
    - `punts` integer, required
    - `punts_blocked` integer, required
    - `punts_inside_20` integer, required
    - `quarterback_hits` integer, required
    - `receiving_air_yds` integer, required: Total receiving air yards
    - `receiving_first_downs` integer, required: Total receiving first downs
    - `receiving_fumbles_lost` integer, required: Total receiving fumbles lost
    - `receiving_tds` integer, required
    - `receiving_yds` integer, required
    - `receiving_yds_after_catch` integer, required: Total receiving YAC
    - `receptions` integer, required
    - `rushing_attempts` integer, required
    - `rushing_first_downs` integer, required: Total rushing first downs
    - `rushing_fumbles_lost` integer, required: Total rushing fumbles lost
    - `rushing_tds` integer, required
    - `rushing_yds` integer, required
    - `sack_fumbles` integer, required: Total fumbles on sacks
    - `sack_fumbles_lost` integer, required: Total sack fumbles lost
    - `sack_yds_lost` integer, required
    - `sacks` number, double, required
    - `sacks_taken` integer, required
    - `safeties` integer, required
    - `season_id` integer, required
    - `special_teams_tds` integer, required: Total special teams touchdowns
    - `tackles_assisted` integer, required
    - `tackles_for_loss` integer, required
    - `tackles_solo` integer, required
    - `targets` integer, required
    - `total_tackles` integer, required
    - `yds_per_attempt` number, double, required
    - `yds_per_carry` number, double, required
    - `yds_per_reception` number, double, required

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