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

# List season_team_stats for NFL

`GET /api/v1/nfl/season_team_stats`

## Request

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

## Query parameters

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

## Response `200`

season_team_stats rows matching the declared filter set.

- NFLSeasonTeamStatsListResponse
  - `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_team_stats` NFLSeasonTeamStats[], required
    - `completions` integer, required
    - `defensive_interceptions` integer, required
    - `defensive_sacks` number, double, required: Sacks recorded by this team's defense (half-sacks supported as decimals).
    - `defensive_tds` integer, required: Touchdowns scored by the defense (interception return + fumble recovery TD); excludes special-teams returns.
    - `extra_pts_attempted` integer, required
    - `extra_pts_made` integer, required
    - `field_goals_attempted` integer, required
    - `field_goals_made` integer, required
    - `first_downs` integer, required
    - `fourth_down_attempts` integer, required: Total fourth-down plays attempted (excludes punts and field-goal attempts).
    - `fourth_down_conversions` integer, required: Fourth-down attempts converted to a first down or touchdown.
    - `fumbles_recovered` integer, required
    - `games_played` integer, required
    - `id` integer, required: Primary Key
    - `losses` integer, required
    - `pass_attempts` integer, required
    - `passing_tds` integer, required
    - `passing_yds` integer, required
    - `pts_allowed` integer, required
    - `pts_scored` integer, required
    - `red_zone_attempts` integer, required: Possessions reaching the red zone (inside the opponent's 20-yard line).
    - `red_zone_conversions` integer, required: Red-zone trips that ended in a touchdown.
    - `rushing_tds` integer, required
    - `rushing_yds` integer, required
    - `season_id` integer, required
    - `team_id` integer, required
    - `third_down_attempts` integer, required: Total third-down plays attempted.
    - `third_down_conversions` integer, required: Third-down attempts converted to a first down or touchdown.
    - `ties` integer, required
    - `total_yds` integer, required
    - `turnovers` integer, required: Possessions lost via interception or fumble.
    - `wins` integer, 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)