STAT-API

NFL stadiums API

stadiumsnfl.stadiums
Venues that have hosted NFL games — current home stadiums, neutral-site locations like international and Super Bowl venues, and historical fields no longer in use.
Full field reference (20 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/nfl/stadiums
Parameters
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/stadiums?limit=3'
Responses
200stadiums rows matching the declared filter set, wrapped in { stadiums, 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(20 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
league_stadium_id
stringnullable—Official NFL stadium ID from API
e.g. 00081065-961a-76b2-de6a-b6da2602a129
address
stringnullable—Street address of the stadium.
e.g. 1 Patriot Pl, Foxborough, MA 02035
capacity
integernullable—Approximate seating capacity for football configuration.
e.g. 65000
city
string——
e.g. Santa Clara
closed_date
timestamptznullable—Date the stadium closed (null if currently in use).
e.g. — (all-null in sample)
country
stringnullable——
Values:USADEUGBRMEXBRAESPIRLAUSFRA
description
stringnullable——
e.g. — (all-null in sample)
elevation
floatnullable—Elevation in feet above sea level
e.g. 256
image_url
stringnullable—URL to aerial/overview image of stadium
e.g. https://upload.wikimedia.org/wikipedia/commons/thumb/7/70/G…
latitude
floatnullable—Latitude of the stadium centroid (decimal degrees, WGS84).
e.g. 37.4033
longitude
floatnullable—Longitude of the stadium centroid (decimal degrees, WGS84).
e.g. -121.9694
name
string——
e.g. Gillette Stadium
opened_date
timestamptznullable—Date the stadium opened for play.
e.g. 2002-01-01T00:00:00.000Z
orientation
floatnullable—Field orientation in degrees (0-360). Direction end zones face, measured from south end zone. 0/360=North, 90=East, 180=South, 270=West
e.g. 0
roof_type
stringnullable—Roof type (e.g., `open`, `dome`, `retractable`).
Values:OpenRetractableDome
state
stringnullable——
e.g. FL
surface
stringnullable—Playing surface type (e.g., `grass`, `FieldTurf`, `Astroturf`).
Values:GrassFieldTurfHybrid GrassA-Turf TitanBermuda GrassUBU Sports Speed Series…
team_name
stringnullable—Team commonly associated with this stadium at the time (display string, not a foreign key).
e.g. NE
timezone
stringnullable—IANA timezone (e.g., America/New_York)
Values:America/New_YorkAmerica/ChicagoAmerica/Los_AngelesEurope/BerlinEurope/LondonAmerica/Mexico_CityAmerica/Sao_PauloEurope/MadridAmerica/Indiana/Indiana…America/DenverAmerica/DetroitAmerica/PhoenixEurope/DublinAustralia/MelbourneEurope/Paris
GET/api/v1/nfl/stadiums/{id}
Parameters
idpathbigintrequired
Primary key (id) of the stadium 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/stadiums/{pk_value}'
Responses
200Single stadium row.application/jsonshow example ▸
404Row not found.
Response Schema(20 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
league_stadium_id
stringnullable—Official NFL stadium ID from API
e.g. 00081065-961a-76b2-de6a-b6da2602a129
address
stringnullable—Street address of the stadium.
e.g. 1 Patriot Pl, Foxborough, MA 02035
capacity
integernullable—Approximate seating capacity for football configuration.
e.g. 65000
city
string——
e.g. Santa Clara
closed_date
timestamptznullable—Date the stadium closed (null if currently in use).
e.g. — (all-null in sample)
country
stringnullable——
Values:USADEUGBRMEXBRAESPIRLAUSFRA
description
stringnullable——
e.g. — (all-null in sample)
elevation
floatnullable—Elevation in feet above sea level
e.g. 256
image_url
stringnullable—URL to aerial/overview image of stadium
e.g. https://upload.wikimedia.org/wikipedia/commons/thumb/7/70/G…
latitude
floatnullable—Latitude of the stadium centroid (decimal degrees, WGS84).
e.g. 37.4033
longitude
floatnullable—Longitude of the stadium centroid (decimal degrees, WGS84).
e.g. -121.9694
name
string——
e.g. Gillette Stadium
opened_date
timestamptznullable—Date the stadium opened for play.
e.g. 2002-01-01T00:00:00.000Z
orientation
floatnullable—Field orientation in degrees (0-360). Direction end zones face, measured from south end zone. 0/360=North, 90=East, 180=South, 270=West
e.g. 0
roof_type
stringnullable—Roof type (e.g., `open`, `dome`, `retractable`).
Values:OpenRetractableDome
state
stringnullable——
e.g. FL
surface
stringnullable—Playing surface type (e.g., `grass`, `FieldTurf`, `Astroturf`).
Values:GrassFieldTurfHybrid GrassA-Turf TitanBermuda GrassUBU Sports Speed Series…
team_name
stringnullable—Team commonly associated with this stadium at the time (display string, not a foreign key).
e.g. NE
timezone
stringnullable—IANA timezone (e.g., America/New_York)
Values:America/New_YorkAmerica/ChicagoAmerica/Los_AngelesEurope/BerlinEurope/LondonAmerica/Mexico_CityAmerica/Sao_PauloEurope/MadridAmerica/Indiana/Indiana…America/DenverAmerica/DetroitAmerica/PhoenixEurope/DublinAustralia/MelbourneEurope/Paris