STAT-API

NFL teams API

teamsnfl.teams
The 32 NFL franchises plus historical predecessors — teams that have since relocated, renamed, or merged into the current league.
Full field reference (12 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/nfl/teams
Parameters
activequerybooleanoptional
Filter by active status (defaults to true to show only currently-active rows; pass active=false to include inactive).
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; 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/teams?limit=3'
Responses
200teams rows matching the declared filter set, wrapped in { teams, 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(12 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
league_team_id
string—Official NFL team UUID from api.nfl.com
e.g. 10403800-517c-7b8c-65a3-c61b95d86123
stadium_id
bigintPrimary home stadium (FK to `stadiums`); null if unknown or shared.
e.g. 16
abbreviation
string—Three-letter team code (e.g., KC, NE, GB).
e.g. ARI
active
boolean—True for currently-active franchises; false for relocated or defunct teams retained for historical references.
e.g. true
city
string——
e.g. Los Angeles
conference
string—Conference assignment (AFC or NFC).
Values:NFCAFC
division
string—Division within the conference (e.g., AFC East, NFC West).
Values:WestSouthNorthEast
full_name
string——
e.g. Arizona Cardinals
name
string——
e.g. Cardinals
primary_color
stringnullable—Hex color code for the team's primary uniform color (e.g., `#A71930`).
e.g. #002244
secondary_color
stringnullable—Hex color code for the team's secondary uniform color.
Values:#000000#FFB612#A5ACAF#C60C30#B0B7BC#A71930#9E7C0C#E64100#311D00#FB4F14#FFC20E#FFD100#F58220#FFC62F#B3995D#69BE28#322F2B#D50A0A
GET/api/v1/nfl/teams/{id}
Parameters
idpathbigintrequired
Primary key (id) of the team 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/teams/{pk_value}'
Responses
200Single team row.application/jsonshow example ▸
404Row not found.
Response Schema(12 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
league_team_id
string—Official NFL team UUID from api.nfl.com
e.g. 10403800-517c-7b8c-65a3-c61b95d86123
stadium_id
bigintPrimary home stadium (FK to `stadiums`); null if unknown or shared.
e.g. 16
abbreviation
string—Three-letter team code (e.g., KC, NE, GB).
e.g. ARI
active
boolean—True for currently-active franchises; false for relocated or defunct teams retained for historical references.
e.g. true
city
string——
e.g. Los Angeles
conference
string—Conference assignment (AFC or NFC).
Values:NFCAFC
division
string—Division within the conference (e.g., AFC East, NFC West).
Values:WestSouthNorthEast
full_name
string——
e.g. Arizona Cardinals
name
string——
e.g. Cardinals
primary_color
stringnullable—Hex color code for the team's primary uniform color (e.g., `#A71930`).
e.g. #002244
secondary_color
stringnullable—Hex color code for the team's secondary uniform color.
Values:#000000#FFB612#A5ACAF#C60C30#B0B7BC#A71930#9E7C0C#E64100#311D00#FB4F14#FFC20E#FFD100#F58220#FFC62F#B3995D#69BE28#322F2B#D50A0A