STAT-API

MLB venues API

venuesmlb.venues
MLB ballparks — current home stadiums and historical venues, with dimensions, surface, capacity, and roof type.
Full field reference (21 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/mlb/venues
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/mlb/venues?limit=3'
Responses
200venues rows matching the declared filter set, wrapped in { venues, 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(21 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
league_venue_id
integernullable—Official MLB venue ID (issued by the league)
e.g. 2523
address
stringnullable——
e.g. — (all-null in sample)
capacity
integernullable——
e.g. 14014
city
string——
e.g. West Sacramento
closed_date
timestamptznullable——
e.g. — (all-null in sample)
country
stringnullable——
Values:USACAN
description
stringnullable——
e.g. — (all-null in sample)
elevation
floatnullable—Elevation in feet above sea level
e.g. 596
hr_factor
decimalnullable—Historical home run park factor (1.0 = neutral)
e.g. — (all-null in sample)
image_url
stringnullable—URL to aerial/overview image of ballpark
e.g. — (all-null in sample)
latitude
floatnullable——
e.g. 27.9778
longitude
floatnullable——
e.g. -82.5055
name
string——
e.g. Sutter Health Park
opened_date
timestamptznullable——
e.g. 2000-05-15T04:00:00.000Z
orientation
floatnullable—Field orientation in degrees (0-360). Direction home plate faces. 0/360=North, 90=East, 180=South, 270=West
e.g. 45
roof_type
stringnullable—Open, Dome, Retractable
Values:OpenRetractableClosed
state
stringnullable——
Values:CAFLILOHTXMONYPAAZGAMDMACOMIWIMNWAONDC
surface
stringnullable——
Values:GrassArtificial TurfNatural Grass
team_name
stringnullable——
e.g. Tampa Bay Rays
timezone
stringnullable—IANA timezone (e.g., America/New_York)
e.g. — (all-null in sample)
GET/api/v1/mlb/venues/{id}
Parameters
idpathbigintrequired
Primary key (id) of the venue 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/mlb/venues/{pk_value}'
Responses
200Single venue row.application/jsonshow example ▸
404Row not found.
Response Schema(21 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
league_venue_id
integernullable—Official MLB venue ID (issued by the league)
e.g. 2523
address
stringnullable——
e.g. — (all-null in sample)
capacity
integernullable——
e.g. 14014
city
string——
e.g. West Sacramento
closed_date
timestamptznullable——
e.g. — (all-null in sample)
country
stringnullable——
Values:USACAN
description
stringnullable——
e.g. — (all-null in sample)
elevation
floatnullable—Elevation in feet above sea level
e.g. 596
hr_factor
decimalnullable—Historical home run park factor (1.0 = neutral)
e.g. — (all-null in sample)
image_url
stringnullable—URL to aerial/overview image of ballpark
e.g. — (all-null in sample)
latitude
floatnullable——
e.g. 27.9778
longitude
floatnullable——
e.g. -82.5055
name
string——
e.g. Sutter Health Park
opened_date
timestamptznullable——
e.g. 2000-05-15T04:00:00.000Z
orientation
floatnullable—Field orientation in degrees (0-360). Direction home plate faces. 0/360=North, 90=East, 180=South, 270=West
e.g. 45
roof_type
stringnullable—Open, Dome, Retractable
Values:OpenRetractableClosed
state
stringnullable——
Values:CAFLILOHTXMONYPAAZGAMDMACOMIWIMNWAONDC
surface
stringnullable——
Values:GrassArtificial TurfNatural Grass
team_name
stringnullable——
e.g. Tampa Bay Rays
timezone
stringnullable—IANA timezone (e.g., America/New_York)
e.g. — (all-null in sample)