STAT-API

NFL season_team_stats API

season_team_statsnfl.season_team_stats
Season totals for each NFL team — wins and losses, points scored and allowed, yards on offense and defense, turnovers, red-zone and down-conversion efficiency, kicking accuracy. Regular-season games only.
Full field reference (32 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/nfl/season_team_stats
Requires one of: season_id — requests satisfying none of these return 400.
Parameters
team_idquerybigintoptional
Filter by team.
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_team_stats?season_id=2026'
Responses
200season_team_stats rows matching the declared filter set, wrapped in { season_team_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(32 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
season_id
bigint—
e.g. 2025
team_id
bigint—
e.g. 1
completions
integer——
e.g. 0
defensive_interceptions
integer——
e.g. 11
defensive_sacks
decimal—Sacks recorded by this team's defense (half-sacks supported as decimals).
e.g. 49.0000
defensive_tds
integer—Touchdowns scored by the defense (interception return + fumble recovery TD); excludes special-teams returns.
e.g. 0
extra_pts_attempted
integer——
e.g. 35
extra_pts_made
integer——
e.g. 33
field_goals_attempted
integer——
e.g. 30
field_goals_made
integer——
e.g. 30
first_downs
integer——
e.g. 301
fourth_down_attempts
integer—Total fourth-down plays attempted (excludes punts and field-goal attempts).
e.g. 21
fourth_down_conversions
integer—Fourth-down attempts converted to a first down or touchdown.
e.g. 13
fumbles_recovered
integer——
e.g. 9
games_played
integer——
e.g. 17
losses
integer——
e.g. 8
pass_attempts
integer——
e.g. 0
passing_tds
integer——
e.g. 0
passing_yds
integer——
e.g. 3703
pts_allowed
integer——
e.g. 407
pts_scored
integer——
e.g. 364
red_zone_attempts
integer—Possessions reaching the red zone (inside the opponent's 20-yard line).
e.g. 0
red_zone_conversions
integer—Red-zone trips that ended in a touchdown.
e.g. 0
rushing_tds
integer——
e.g. 0
rushing_yds
integer——
e.g. 2662
third_down_attempts
integer—Total third-down plays attempted.
e.g. 224
third_down_conversions
integer—Third-down attempts converted to a first down or touchdown.
e.g. 82
ties
integer——
e.g. 0
total_yds
integer——
e.g. 6299
turnovers
integer—Possessions lost via interception or fumble.
e.g. 24
wins
integer——
e.g. 3
GET/api/v1/nfl/season_team_stats/{id}
Parameters
idpathbigintrequired
Primary key (id) of the season_team_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_team_stats/{pk_value}'
Responses
200Single season_team_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(32 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
season_id
bigint—
e.g. 2025
team_id
bigint—
e.g. 1
completions
integer——
e.g. 0
defensive_interceptions
integer——
e.g. 11
defensive_sacks
decimal—Sacks recorded by this team's defense (half-sacks supported as decimals).
e.g. 49.0000
defensive_tds
integer—Touchdowns scored by the defense (interception return + fumble recovery TD); excludes special-teams returns.
e.g. 0
extra_pts_attempted
integer——
e.g. 35
extra_pts_made
integer——
e.g. 33
field_goals_attempted
integer——
e.g. 30
field_goals_made
integer——
e.g. 30
first_downs
integer——
e.g. 301
fourth_down_attempts
integer—Total fourth-down plays attempted (excludes punts and field-goal attempts).
e.g. 21
fourth_down_conversions
integer—Fourth-down attempts converted to a first down or touchdown.
e.g. 13
fumbles_recovered
integer——
e.g. 9
games_played
integer——
e.g. 17
losses
integer——
e.g. 8
pass_attempts
integer——
e.g. 0
passing_tds
integer——
e.g. 0
passing_yds
integer——
e.g. 3703
pts_allowed
integer——
e.g. 407
pts_scored
integer——
e.g. 364
red_zone_attempts
integer—Possessions reaching the red zone (inside the opponent's 20-yard line).
e.g. 0
red_zone_conversions
integer—Red-zone trips that ended in a touchdown.
e.g. 0
rushing_tds
integer——
e.g. 0
rushing_yds
integer——
e.g. 2662
third_down_attempts
integer—Total third-down plays attempted.
e.g. 224
third_down_conversions
integer—Third-down attempts converted to a first down or touchdown.
e.g. 82
ties
integer——
e.g. 0
total_yds
integer——
e.g. 6299
turnovers
integer—Possessions lost via interception or fumble.
e.g. 24
wins
integer——
e.g. 3