Schemas

ServiceName

string

The layer or service name.

last-12 - total precipitation in the last 12 hours
last-24 - total precipitation in the last 24 hours
last-48 - total precipitation in the last 48 hours
last-168 - total precipitation in the last 168 hours (7 days)
hourly - total hourly precipitation
wind-speed-hourly - average hourly wind speed
wind-direction-hourly - average hourly wind direction
temperature-hourly - average hourly temperature

Example: last-48

DailyProperties

object[] · required

timeZoneId

string · required

Day

startTime

string · date-time · required

ISO 8601 timestamp marking the start of the day

precip

number · min: 0 · required

Total precipitation amount in millimeters for the day

precip_type

string · enum · required

Type of precipitation that occurred or is forecasted for the day

Enum values:

rain

snow

mixed

source

string · enum · required

Whether this data comes from historical observations or forecast models

Enum values:

observation

forecast

precip_probability

integer | null · min: 0 · max: 100

Probability of precipitation as a percentage (0-100). Null for historical observations.

GetSamples_Response

unit

string · enum

Display unit of sample values

Enum values:

fahrenheit

celsius

inches

m/s

percent

ratio

degrees

object[]

FeatureCollection_DailyProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_DailySoilProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlySoilProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlyTemperatureProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlySoilTemperatureProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_DailySnowDepthProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlySpecificHumidityProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlyWindSpeedProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlyWindGustProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlyWindDirectionProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlyCloudCoverProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlyRelativeHumidityProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlyPressureProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlySolarRadiationProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_HourlyProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_MinutelyProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_Last48Properties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

FeatureCollection_RecentRainProperties_

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

Feature_DailyProperties_

type

string · enum · required

Enum values:

Feature

object · required

Feature_HourlyProperties_

type

string · enum · required

Enum values:

Feature

object · required

Feature_MinutelyProperties_

type

string · enum · required

Enum values:

Feature

object · required

Feature_Last48Properties_

type

string · enum · required

Enum values:

Feature

object · required

Feature_RecentRainProperties_

type

string · enum · required

Enum values:

Feature

object · required

HTTPValidationError

object[]

Hour

startTime

string · date-time · required

ISO 8601 timestamp marking the start of the hour

precip

number · min: 0 · required

Total precipitation amount in millimeters for the hour

precip_type

string · enum · required

Type of precipitation that occurred or is forecasted for the hour

Enum values:

rain

snow

mixed

source

string · enum · required

Whether this data comes from historical observations or forecast models

Enum values:

observation

forecast

precip_probability

integer | null · min: 0 · max: 100

Probability of precipitation as a percentage (0-100). Null for historical observations.

Minute

startTime

string · date-time · required

ISO 8601 timestamp marking the start of the minute

precip_rate

number | null · min: 0 · required

Instantaneous precipitation rate in mm/h (or in/h when units=imperial). Null when no 2-minute or 5-minute coverage exists for this minute.

precip_type

string · enum · required

Type of precipitation for the containing hour. none when the minute is dry or uncovered.

Enum values:

rain

snow

sleet

freezing rain

none

source

string | null · enum

observation = 2-minute MRMS analysis; nowcast = 5-minute nowcast at or before now; forecast = 5-minute nowcast after now. Null when uncovered.

Enum values:

observation

nowcast

forecast

HourlyProperties

object[] · required

timeZoneId

string · required

MinutelyProperties

object[] · required

timeZoneId

string · required

unit

string

Display unit for precip_rate: mm/h or in/h

Last48Properties

precip

number · required

endTime

string · required

Point

type

string · enum · required

Enum values:

Point

coordinates

number[] · minItems: 2 · maxItems: 3 · required

RecentRainProperties

precip

number · min: 0 · required

Total precipitation amount in millimeters for the rain event

precip_type

string · enum · required

Type of precipitation that occurred during the event

Enum values:

rain

snow

mixed

slr

number · min: 0 · required

Snow-to-liquid ratio (defaults to 10:1)

snow

number · min: 0 · required

Snow accumulation in millimeters (liquid equivalent)

rain

number · min: 0 · required

Liquid rain amount in millimeters

endTime

string · date-time · required

ISO 8601 timestamp when the rain event ended

ago

string · required

Human-readable description of how long ago the rain event ended

details

string · required

Additional information about the data source or quality

ValidationError

array · required

msg

string · required

type

string · required

ForecastHour

time

string

Local label of the end of the hour, e.g. 1 PM for 12:00-13:00

Example: 1 PM

startTime

string

Start of the hour in UTC (ISO 8601)

Example: 2026-10-19T17:00Z

temperature

number | null

Air temperature (°C or °F)

apparent_temperature

number | null

Feels-like temperature (°C or °F)

precip

number | null

Liquid-equivalent precipitation in the hour (mm or inch)

rain

number | null

Part of precip that falls as rain, sleet or freezing rain (mm or inch)

snow_liquid

number | null

Part of precip that falls as snow, as liquid (mm or inch)

snowfall

number | null

Snow depth from snow_liquid at the slr ratio (cm with mm, inch with inch)

slr

number

Snow-to-liquid ratio used for snowfall

Example: 10

precip_type

string | null · enum

Precipitation type. Null when the type is unknown.

Enum values:

none

rain

snow

sleet

freezing rain

precip_probability

number | null

Chance of precipitation (0-100 %)

weathercode

number | null

WMO weather interpretation code

is_day

integer · enum

1 when the sun is up at the middle of the hour

Enum values:

wind_speed

number | null

Wind speed (m/s)

wind_speed_gust

number | null

Wind gust (m/s)

wind_direction

number | null

Direction the wind blows from (degrees)

cloud_cover

number | null

Cloud cover (0-100 %)

relative_humidity

number | null

Relative humidity (0-100 %)

uv_index

number | null

UV index

us_aqi

number | null

US Air Quality Index

frost_probability_36f

number | null

Chance the temperature is at or below 36 °F (0-100 %)

frost_probability_32f

number | null

Chance the temperature is at or below 32 °F (0-100 %)

frost_probability_28f

number | null

Chance the temperature is at or below 28 °F (0-100 %)

ForecastDailyRange

min

number

max

number

ForecastResponse

Daily maps are keyed by local date (`YYYY-MM-DD`). The first and last days only cover the hours in the request window.

object[]

object

Daily low and high temperature

Example: {"2026-10-20":{"min":5.9,"max":14.9}}

object

Daily precipitation total.

Example: {"2026-10-20":3.2}

object

Highest hourly chance of precipitation in the day (0-100 %)

Example: {"2026-10-20":70}

object

Daily low and high relative humidity (%)

object

Highest UV index in the day

ErrorResponse

error

string · required

Error message describing what went wrong

code

string · required

Error code for programmatic handling

object

Additional error details

ServiceName

string

The layer or service name.

last-12 - total precipitation in the last 12 hours
last-24 - total precipitation in the last 24 hours
last-48 - total precipitation in the last 48 hours
last-168 - total precipitation in the last 168 hours (7 days)
hourly - total hourly precipitation
wind-speed-hourly - average hourly wind speed
wind-direction-hourly - average hourly wind direction
temperature-hourly - average hourly temperature

Example: last-48

Day

startTime

string · date-time · required

ISO 8601 timestamp marking the start of the day

precip

number · min: 0 · required

Total precipitation amount in millimeters for the day

precip_type

string · enum · required

Type of precipitation that occurred or is forecasted for the day

Enum values:

rain

snow

mixed

source

string · enum · required

Whether this data comes from historical observations or forecast models

Enum values:

observation

forecast

precip_probability

integer | null · min: 0 · max: 100

Probability of precipitation as a percentage (0-100). Null for historical observations.

Hour

startTime

string · date-time · required

ISO 8601 timestamp marking the start of the hour

precip

number · min: 0 · required

Total precipitation amount in millimeters for the hour

precip_type

string · enum · required

Type of precipitation that occurred or is forecasted for the hour

Enum values:

rain

snow

mixed

source

string · enum · required

Whether this data comes from historical observations or forecast models

Enum values:

observation

forecast

precip_probability

integer | null · min: 0 · max: 100

Probability of precipitation as a percentage (0-100). Null for historical observations.

Minute

startTime

string · date-time · required

ISO 8601 timestamp marking the start of the minute

precip_rate

number | null · min: 0 · required

Instantaneous precipitation rate in mm/h (or in/h when units=imperial). Null when no 2-minute or 5-minute coverage exists for this minute.

precip_type

string · enum · required

Type of precipitation for the containing hour. none when the minute is dry or uncovered.

Enum values:

rain

snow

sleet

freezing rain

none

source

string | null · enum

observation = 2-minute MRMS analysis; nowcast = 5-minute nowcast at or before now; forecast = 5-minute nowcast after now. Null when uncovered.

Enum values:

observation

nowcast

forecast

RecentRainProperties

precip

number · min: 0 · required

Total precipitation amount in millimeters for the rain event

precip_type

string · enum · required

Type of precipitation that occurred during the event

Enum values:

rain

snow

mixed

slr

number · min: 0 · required

Snow-to-liquid ratio (defaults to 10:1)

snow

number · min: 0 · required

Snow accumulation in millimeters (liquid equivalent)

rain

number · min: 0 · required

Liquid rain amount in millimeters

endTime

string · date-time · required

ISO 8601 timestamp when the rain event ended

ago

string · required

Human-readable description of how long ago the rain event ended

details

string · required

Additional information about the data source or quality

ForecastHour

time

string

Local label of the end of the hour, e.g. 1 PM for 12:00-13:00

Example: 1 PM

startTime

string

Start of the hour in UTC (ISO 8601)

Example: 2026-10-19T17:00Z

temperature

number | null

Air temperature (°C or °F)

apparent_temperature

number | null

Feels-like temperature (°C or °F)

precip

number | null

Liquid-equivalent precipitation in the hour (mm or inch)

rain

number | null

Part of precip that falls as rain, sleet or freezing rain (mm or inch)

snow_liquid

number | null

Part of precip that falls as snow, as liquid (mm or inch)

snowfall

number | null

Snow depth from snow_liquid at the slr ratio (cm with mm, inch with inch)

slr

number

Snow-to-liquid ratio used for snowfall

Example: 10

precip_type

string | null · enum

Precipitation type. Null when the type is unknown.

Enum values:

none

rain

snow

sleet

freezing rain

precip_probability

number | null

Chance of precipitation (0-100 %)

weathercode

number | null

WMO weather interpretation code

is_day

integer · enum

1 when the sun is up at the middle of the hour

Enum values:

wind_speed

number | null

Wind speed (m/s)

wind_speed_gust

number | null

Wind gust (m/s)

wind_direction

number | null

Direction the wind blows from (degrees)

cloud_cover

number | null

Cloud cover (0-100 %)

relative_humidity

number | null

Relative humidity (0-100 %)

uv_index

number | null

UV index

us_aqi

number | null

US Air Quality Index

frost_probability_36f

number | null

Chance the temperature is at or below 36 °F (0-100 %)

frost_probability_32f

number | null

Chance the temperature is at or below 32 °F (0-100 %)

frost_probability_28f

number | null

Chance the temperature is at or below 28 °F (0-100 %)

ForecastResponse

Daily maps are keyed by local date (`YYYY-MM-DD`). The first and last days only cover the hours in the request window.

object[]

object

Daily low and high temperature

Example: {"2026-10-20":{"min":5.9,"max":14.9}}

object

Daily precipitation total.

Example: {"2026-10-20":3.2}

object

Highest hourly chance of precipitation in the day (0-100 %)

Example: {"2026-10-20":70}

object

Daily low and high relative humidity (%)

object

Highest UV index in the day