NBA stadiums API
stadiums
nba.stadiumsNBA arenas — current home venues and historical buildings the league's teams have played in.
GET/api/v1/nba/stadiumsList stadiums for NBA
Parameters
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/nba/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/jsonResponse Schema(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_stadium_id | integernullable | — | Official NBA arena ID (issued by the league) e.g. 643 |
address | stringnullable | — | — e.g. — (all-null in sample) |
capacity | integernullable | — | — e.g. — (all-null in sample) |
city | string | — | — e.g. Orlando |
closed_date | timestamptznullable | — | — e.g. — (all-null in sample) |
country | stringnullable | — | — Values:USMXGBFRDEAEJPCA |
description | stringnullable | — | — e.g. Home of the Toronto Raptors. Multi-purpose arena in downtow… |
elevation | floatnullable | — | Elevation in feet above sea level e.g. 198 |
image_url | stringnullable | — | URL to aerial/overview image of arena e.g. — (all-null in sample) |
latitude | floatnullable | — | — e.g. 25.7814 |
longitude | floatnullable | — | — e.g. -80.187 |
name | string | — | — e.g. Scotiabank Arena |
opened_date | timestamptznullable | — | — e.g. — (all-null in sample) |
roof_type | stringnullable | — | Arena roof type (all indoor) e.g. — (all-null in sample) |
state | stringnullable | — | — e.g. FL |
surface | stringnullable | — | — e.g. — (all-null in sample) |
team_name | stringnullable | — | — e.g. — (all-null in sample) |
timezone | stringnullable | — | IANA timezone (e.g., America/New_York) Values:America/New_YorkAmerica/ChicagoAmerica/Los_AngelesAmerica/DenverAmerica/PhoenixAmerica/Mexico_CityAmerica/TorontoAmerica/Indiana/Indiana…Europe/LondonEurope/ParisEurope/BerlinAsia/DubaiAmerica/Puerto_RicoAmerica/VancouverAsia/ShanghaiPacific/HonoluluAsia/TokyoAmerica/EdmontonAmerica/Montreal |
GET/api/v1/nba/stadiums/{id}Get a single stadium by id
Parameters
idpathbigintrequiredPrimary 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/nba/stadiums/{pk_value}'Responses
200Single stadium row.application/jsonshow example ▸
404Row not found.
Response Schema(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_stadium_id | integernullable | — | Official NBA arena ID (issued by the league) e.g. 643 |
address | stringnullable | — | — e.g. — (all-null in sample) |
capacity | integernullable | — | — e.g. — (all-null in sample) |
city | string | — | — e.g. Orlando |
closed_date | timestamptznullable | — | — e.g. — (all-null in sample) |
country | stringnullable | — | — Values:USMXGBFRDEAEJPCA |
description | stringnullable | — | — e.g. Home of the Toronto Raptors. Multi-purpose arena in downtow… |
elevation | floatnullable | — | Elevation in feet above sea level e.g. 198 |
image_url | stringnullable | — | URL to aerial/overview image of arena e.g. — (all-null in sample) |
latitude | floatnullable | — | — e.g. 25.7814 |
longitude | floatnullable | — | — e.g. -80.187 |
name | string | — | — e.g. Scotiabank Arena |
opened_date | timestamptznullable | — | — e.g. — (all-null in sample) |
roof_type | stringnullable | — | Arena roof type (all indoor) e.g. — (all-null in sample) |
state | stringnullable | — | — e.g. FL |
surface | stringnullable | — | — e.g. — (all-null in sample) |
team_name | stringnullable | — | — e.g. — (all-null in sample) |
timezone | stringnullable | — | IANA timezone (e.g., America/New_York) Values:America/New_YorkAmerica/ChicagoAmerica/Los_AngelesAmerica/DenverAmerica/PhoenixAmerica/Mexico_CityAmerica/TorontoAmerica/Indiana/Indiana…Europe/LondonEurope/ParisEurope/BerlinAsia/DubaiAmerica/Puerto_RicoAmerica/VancouverAsia/ShanghaiPacific/HonoluluAsia/TokyoAmerica/EdmontonAmerica/Montreal |