MLB game_weathers API
game_weathers
mlb.game_weathersOn-field weather throughout each MLB game — temperature, wind direction and speed, humidity, and precipitation captured at fixed intervals from first pitch.
GET/api/v1/mlb/game_weathersList game_weathers for MLB
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
venue_idquerybigintoptionalFilter by venue.
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/mlb/game_weathers?game_id=1'Responses
200game_weathers rows matching the declared filter set, wrapped in { game_weathers, 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(27 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 1454 | |
venue_id | bigint | — e.g. 14 | |
air_density | floatnullable | — | Calculated air density (lb/ft³) e.g. — (all-null in sample) |
ball_carry_factor | decimalnullable | — | Estimated ball carry factor (1.0 = neutral, >1 = carries more) e.g. — (all-null in sample) |
cloud_cover | floatnullable | — | — e.g. — (all-null in sample) |
dew_point | floatnullable | — | — e.g. — (all-null in sample) |
feels_like_temperature | floatnullable | — | — e.g. — (all-null in sample) |
humidity | floatnullable | — | — e.g. — (all-null in sample) |
is_dome | booleannullable | — | — Values:falsetrue |
precipitation | floatnullable | — | — e.g. — (all-null in sample) |
precipitation_probability | floatnullable | — | — e.g. — (all-null in sample) |
pressure | floatnullable | — | — e.g. — (all-null in sample) |
recorded_at | timestamptznullable | — | — e.g. 2018-09-30T19:10:00.000Z |
roof_status | stringnullable | — | open, closed, retractable_open, retractable_closed Values:ClosedOpen |
temperature | floatnullable | — | — e.g. 72 |
time_minutes | integer | — | Minutes from game start (0, 30, 60, 90, 120, 150, 180 for 3-hour game) e.g. 0 |
uv_index | floatnullable | — | — e.g. — (all-null in sample) |
visibility | floatnullable | — | — e.g. — (all-null in sample) |
weather_condition | stringnullable | — | — Values:Partly CloudyClearCloudyRoof ClosedSunnyOvercastDomeRainDrizzleSnow |
weather_description | stringnullable | — | — Values:NoneOut To CFL To RR To LOut To LFOut To RFIn From RFIn From CFIn From LFVariesCalm |
wind_blowing_out | booleannullable | — | True if wind is blowing from home plate toward outfield Values:truefalse |
wind_component_out | floatnullable | — | Wind speed component blowing out to CF (mph, negative = blowing in) e.g. — (all-null in sample) |
wind_direction | floatnullable | — | — e.g. — (all-null in sample) |
wind_direction_relative | floatnullable | — | Wind direction relative to batter's box (degrees) e.g. — (all-null in sample) |
wind_gust | floatnullable | — | — e.g. — (all-null in sample) |
wind_speed | floatnullable | — | — e.g. 0 |
GET/api/v1/mlb/game_weathers/{id}Get a single game_weather by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_weather 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/game_weathers/{pk_value}'Responses
200Single game_weather row.application/jsonshow example ▸
404Row not found.
Response Schema(27 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 1454 | |
venue_id | bigint | — e.g. 14 | |
air_density | floatnullable | — | Calculated air density (lb/ft³) e.g. — (all-null in sample) |
ball_carry_factor | decimalnullable | — | Estimated ball carry factor (1.0 = neutral, >1 = carries more) e.g. — (all-null in sample) |
cloud_cover | floatnullable | — | — e.g. — (all-null in sample) |
dew_point | floatnullable | — | — e.g. — (all-null in sample) |
feels_like_temperature | floatnullable | — | — e.g. — (all-null in sample) |
humidity | floatnullable | — | — e.g. — (all-null in sample) |
is_dome | booleannullable | — | — Values:falsetrue |
precipitation | floatnullable | — | — e.g. — (all-null in sample) |
precipitation_probability | floatnullable | — | — e.g. — (all-null in sample) |
pressure | floatnullable | — | — e.g. — (all-null in sample) |
recorded_at | timestamptznullable | — | — e.g. 2018-09-30T19:10:00.000Z |
roof_status | stringnullable | — | open, closed, retractable_open, retractable_closed Values:ClosedOpen |
temperature | floatnullable | — | — e.g. 72 |
time_minutes | integer | — | Minutes from game start (0, 30, 60, 90, 120, 150, 180 for 3-hour game) e.g. 0 |
uv_index | floatnullable | — | — e.g. — (all-null in sample) |
visibility | floatnullable | — | — e.g. — (all-null in sample) |
weather_condition | stringnullable | — | — Values:Partly CloudyClearCloudyRoof ClosedSunnyOvercastDomeRainDrizzleSnow |
weather_description | stringnullable | — | — Values:NoneOut To CFL To RR To LOut To LFOut To RFIn From RFIn From CFIn From LFVariesCalm |
wind_blowing_out | booleannullable | — | True if wind is blowing from home plate toward outfield Values:truefalse |
wind_component_out | floatnullable | — | Wind speed component blowing out to CF (mph, negative = blowing in) e.g. — (all-null in sample) |
wind_direction | floatnullable | — | — e.g. — (all-null in sample) |
wind_direction_relative | floatnullable | — | Wind direction relative to batter's box (degrees) e.g. — (all-null in sample) |
wind_gust | floatnullable | — | — e.g. — (all-null in sample) |
wind_speed | floatnullable | — | — e.g. 0 |