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

# List teams for NFL

`GET /api/v1/nfl/teams`

## Request

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

## Query parameters

- `active` boolean
- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

teams rows matching the declared filter set.

- NFLTeamsListResponse
  - `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`.
  - `teams` NFLTeams[], required
    - `abbreviation` string, required: Three-letter team code (e.g., KC, NE, GB).
    - `active` boolean, required: True for currently-active franchises; false for relocated or defunct teams retained for historical references.
    - `city` string, required
    - `conference` string, required: Conference assignment (AFC or NFC).
    - `division` string, required: Division within the conference (e.g., AFC East, NFC West).
    - `full_name` string, required
    - `id` integer, required: Primary Key
    - `league_team_id` string, required: Official NFL team UUID from api.nfl.com
    - `name` string, required
    - `primary_color` string, nullable: Hex color code for the team's primary uniform color (e.g., `#A71930`).
    - `secondary_color` string, nullable: Hex color code for the team's secondary uniform color.
    - `stadium_id` integer, required: Primary home stadium (FK to `stadiums`); null if unknown or shared.

## 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/601ff9eaca3f?raw)