park_factorsmlb.park_factors

How each MLB ballpark inflates or suppresses run-scoring categories — runs, home runs, doubles, triples, and batting average relative to a neutral park, computed per season.

Full field reference (18 columns) → Data Dictionary Query in GraphQL →

GET/api/v1/mlb/park_factorsList park_factors for MLB

Requires one of: venue_id — requests satisfying none of these return 400.

Parameters

venue_idquerybigintoptional

Filter by venue.

season_idquerybigintoptional

Filter to a season.

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/park_factors?venue_id=1'

Responses

200park_factors rows matching the declared filter set, wrapped in { park_factors, 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(18 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
season_id	bigint		— e.g. 2024
venue_id	bigint		— e.g. 12
basic_park_factor	decimal	—	Overall park factor for runs (1.0 = neutral) e.g. 1.2200
double_factor	decimal	—	Park factor for doubles e.g. 1.2600
fly_ball_factor	decimalnullable	—	Park factor for fly balls e.g. — (all-null in sample)
ground_ball_factor	decimalnullable	—	Park factor for ground balls e.g. — (all-null in sample)
handedness_factor	decimal	—	Park effect on handedness advantage e.g. 1.1600
home_run_factor	decimal	—	Park factor for home runs (1.0 = neutral) e.g. 1.3300
left_handed_factor	decimal	—	Park factor for left-handed batters e.g. 1.1400
right_handed_factor	decimal	—	Park factor for right-handed batters e.g. 1.1800
run_factor	decimalnullable	—	Park factor for total runs e.g. — (all-null in sample)
single_factor	decimal	—	Park factor for singles e.g. 1.1100
strikeout_factor	decimal	—	Park factor for strikeouts e.g. 0.8900
triple_factor	decimal	—	Park factor for triples e.g. 1.4200
updated_date	timestamptz	—	— e.g. 2026-04-12T02:04:46.363Z
walk_factor	decimal	—	Park factor for walks e.g. 1.0100
years_of_data	integer	—	Number of years used to calculate factors e.g. 3

GET/api/v1/mlb/park_factors/{id}Get a single park_factor by id

Parameters

idpathbigintrequired

Primary key (id) of the park_factor 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/park_factors/{pk_value}'

Responses

200Single park_factor row.application/jsonshow example ▸

404Row not found.

Response Schema(18 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
season_id	bigint		— e.g. 2024
venue_id	bigint		— e.g. 12
basic_park_factor	decimal	—	Overall park factor for runs (1.0 = neutral) e.g. 1.2200
double_factor	decimal	—	Park factor for doubles e.g. 1.2600
fly_ball_factor	decimalnullable	—	Park factor for fly balls e.g. — (all-null in sample)
ground_ball_factor	decimalnullable	—	Park factor for ground balls e.g. — (all-null in sample)
handedness_factor	decimal	—	Park effect on handedness advantage e.g. 1.1600
home_run_factor	decimal	—	Park factor for home runs (1.0 = neutral) e.g. 1.3300
left_handed_factor	decimal	—	Park factor for left-handed batters e.g. 1.1400
right_handed_factor	decimal	—	Park factor for right-handed batters e.g. 1.1800
run_factor	decimalnullable	—	Park factor for total runs e.g. — (all-null in sample)
single_factor	decimal	—	Park factor for singles e.g. 1.1100
strikeout_factor	decimal	—	Park factor for strikeouts e.g. 0.8900
triple_factor	decimal	—	Park factor for triples e.g. 1.4200
updated_date	timestamptz	—	— e.g. 2026-04-12T02:04:46.363Z
walk_factor	decimal	—	Park factor for walks e.g. 1.0100
years_of_data	integer	—	Number of years used to calculate factors e.g. 3