Conditions

Return ranked weather conditions, an icon, and a plain-language summary for each requested hourly interval, local calendar day, and day or night period across a point forecast's available horizon, up to 360 hours.

Choose wm-6 (WeatherMesh-6) or mm (MetaMesh) using the model dropdown. For MetaMesh forecast values alongside conditions, use Weather Context with include_conditions=true.

/models/v1/wm-6/point_forecast/conditions/models/v1/wm-6/point_forecast/conditions

/models/v1/mm/point_forecast/conditions/models/v1/mm/point_forecast/conditions

windborne point_forecast_conditionswindborne point_forecast_conditions

from windborne import get_point_forecast_conditionsfrom windborne import get_point_forecast_conditions

Query Parameters

Name	Type	Description
coordinates Required	string (lat,lon;...)	Latitude,longitude pairs separated by semicolons, for example `37,-121;40.3,-100`. Results preserve the input order. Range: latitude −90° to 90°, longitude −180° to 180°; Max: 10 pairs
hourly_interval Optional	integer	Duration of each condition block in the `hourly` forecast. Allowed: `1`, `2`, `3`, `4`, `6`, `8`; Unit: hours; Default: `1`
include_sky_state_icon Optional	boolean	Add `sky_state_icon_url` and `sky_state_condition` to every hourly, daily, and day/night block. Both fields are omitted when false. Default: `false`

Name	Type	Description
coordinates Required	string (lat,lon;...)	Latitude,longitude pairs separated by semicolons, for example `37,-121;40.3,-100`. Results preserve the input order. Range: latitude −90° to 90°, longitude −180° to 180°; Max: 10 pairs
-m , --model Optional	string	Weather model to use. Allowed: `wm-6`, `mm`; Default: `wm-6`
--hourly-interval Optional	integer	Duration of each condition block in the `hourly` forecast. Allowed: `1`, `2`, `3`, `4`, `6`, `8`; Unit: hours; Default: `1`
--include-sky-state-icon Optional	flag	Add `sky_state_icon_url` and `sky_state_condition` to every hourly, daily, and day/night block. Both fields are omitted when false. Default: `false`
output_file Optional	string	JSON file to which the response will be written. If omitted, the response is printed to stdout.

Name	Type	Description
coordinates Required	str \| list[tuple]	Latitude,longitude pairs separated by semicolons, for example `37,-121;40.3,-100`. Results preserve the input order. Also accepts a list of `(lat, lon)` tuples. Range: latitude −90° to 90°, longitude −180° to 180°; Max: 10 pairs
model Optional	str	Weather model to use. Allowed: `wm-6`, `mm`; Default: `wm-6`
hourly_interval Optional	int	Duration of each condition block in the `hourly` forecast. Allowed: `1`, `2`, `3`, `4`, `6`, `8`; Unit: hours; Default: `1`
include_sky_state_icon Optional	bool	Add `sky_state_icon_url` and `sky_state_condition` to every hourly, daily, and day/night block. Both fields are omitted when false. Default: `false`
output_file Optional	str	JSON file to which the response will be written.
print_response Optional	bool	If true, prints the response data. Default: `false`

Time Blocks

All response arrays are chronological. Each window includes its start_time and excludes its end_time, so adjacent windows do not overlap. Although local time determines the daily and day/night boundaries, every timestamp is returned in UTC. The hourly array covers the available forecast horizon beginning at forecast_zero.

Block	Behavior
hourly	Contiguous windows anchored at `forecast_zero`, each containing the number of hours selected by `hourly_interval`. The final window is clipped to the available forecast horizon.
daily	Local midnight-to-midnight windows. The first and last windows are clipped to the forecast horizon. Daylight-saving transitions can produce 23- or 25-hour windows.
day_night	Alternating local sunrise-to-sunset `day` windows and sunset-to-sunrise `night` windows. The first and last windows are clipped to the forecast horizon. If an astronomical sunrise or sunset is unavailable for a polar location, the endpoint falls back to 06:00 and 18:00 local time.

Response Fields

With include_sky_state_icon=true, each block includes an additional icon selected from its cloud and precipitation conditions. The primary icon_url, ranked conditions, and text are unchanged.

Name	Type	Description
forecasts	object[]	Condition forecasts in the same order as the input coordinates.
latitude	number	Requested latitude. Unit: degrees
longitude	number	Requested longitude. Unit: degrees
timezone	string	Timezone used to calculate local daily and day/night boundaries.
hourly	object[]	Condition blocks spanning the available forecast horizon at the requested `hourly_interval`.
icon_url	string	Absolute URL for an icon summarizing the block.
sky_state_icon_url	string	Additional cloud and precipitation icon. Present when: `include_sky_state_icon=true`
sky_state_condition	string \| null	Highest-ranked cloud or precipitation condition used to select the additional icon, or null when none is available. Present when: `include_sky_state_icon=true`
conditions	string[]	Conditions, ordered from highest to lowest importance. Neutral states, such as calm wind, are omitted. Precipitation entries include their likelihood, such as `Low chance of drizzle`, unless precipitation is near certain, as in `Rain`.
start_time	string (ISO 8601)	Inclusive start of the block.
end_time	string (ISO 8601)	Exclusive end of the block.
text	string	Plain-language paragraph describing conditions during the block.
daily	object[]	Condition blocks grouped by the location's local calendar day.
icon_url	string	Absolute URL for an icon summarizing the block.
sky_state_icon_url	string	Additional cloud and precipitation icon. Present when: `include_sky_state_icon=true`
sky_state_condition	string \| null	Highest-ranked cloud or precipitation condition used to select the additional icon, or null when none is available. Present when: `include_sky_state_icon=true`
conditions	string[]	Conditions, ordered from highest to lowest importance. Neutral states, such as calm wind, are omitted. Precipitation entries include their likelihood, such as `Low chance of drizzle`, unless precipitation is near certain, as in `Rain`.
start_time	string (ISO 8601)	Inclusive start of the block.
end_time	string (ISO 8601)	Exclusive end of the block.
text	string	Plain-language paragraph describing conditions during the block.
day_night	object[]	Condition blocks grouped by local astronomical day and night periods.
icon_url	string	Absolute URL for an icon summarizing the block.
sky_state_icon_url	string	Additional cloud and precipitation icon. Present when: `include_sky_state_icon=true`
sky_state_condition	string \| null	Highest-ranked cloud or precipitation condition used to select the additional icon, or null when none is available. Present when: `include_sky_state_icon=true`
conditions	string[]	Conditions, ordered from highest to lowest importance. Neutral states, such as calm wind, are omitted. Precipitation entries include their likelihood, such as `Low chance of drizzle`, unless precipitation is near certain, as in `Rain`.
start_time	string (ISO 8601)	Inclusive start of the block.
end_time	string (ISO 8601)	Exclusive end of the block.
text	string	Plain-language paragraph describing conditions during the block.
period	string	Whether the block covers daytime or nighttime. Allowed: `day`, `night`
forecast_zero	string (ISO 8601)	Valid time of the first returned forecast point and the start of the first `hourly` block.
initialization_time	string (ISO 8601)	The forecast initialization time. This can be later than `forecast_zero`.

Edge Cases

Over open ocean, timezone is a fixed UTC offset instead of an IANA name. For example, 30, -140 in the North Pacific returns UTC-09:00.

GET Conditions

Query Parameters

Time Blocks

Response Fields

Edge Cases