API playground

location

hourly_hours

include current · hourly · alerts · uncertainty

latnumber

-90 to 90. Latitude (WGS84 decimal degrees).

Give it with lon. On a route that also takes zip or location, give only one location form.

lonnumber

-180 to 180. Longitude (WGS84 decimal degrees).

Give it with lat. On a route that also takes zip or location, give only one location form.

zipstring

5-digit US ZIP code.

Mutually exclusive with lat/lon and location.

unitsstring

Unit system for numeric response fields.

imperial (default) uses °F, mph, inHg, mi, in; metric uses °C, kph, hPa, km, mm. See the Units schema returned with every response for the exact label set.

daysinteger

1 to 14. Number of days for the daily forecast.

viewstring

Column preset for hourly and daily rows.

detailed (default) returns every column; concise returns the documented subset (20 hourly and 22 daily columns, listed in the GET /v1/weather description) and never drops rows. include wins over the preset. The enum and the concise preset only grow. Any other value is a 400.

hourly_stepinteger

1 to 24. Keep one hourly row every hourly_step hours (by whole-hour offset from hourly[0].time), from hourly_step_from on.

1 (default) keeps every row. Out of range or non-integer is a 400.

hourly_step_frominteger

0 to 168. Offset in hours from hourly[0].time below which every hourly row is kept; hourly_step applies from this offset on.

0 (default) thins from the first row. A no-op when hourly_step is 1. Out of range is a 400.

fieldsstring

Sparse fieldset for hourly and daily rows:

comma-separated section.name paths, where section is hourly or daily and name is the exact JSON member name (no aliases). Whitespace is trimmed, paths are lowercased, duplicates collapse, and repeated fields parameters are concatenated; at most 64 distinct paths. A second segment is allowed only under the objects that are not taken whole: hourly.uncertainty, daily.day, daily.night, daily.uncertainty, daily.climate (e.g. daily.day.precip_probability). Every other member, including daily.astro and daily.threats, is selected whole. fields is exact for each section it names and overrides view there; hourly[].time and daily[].date are always returned. fields never implies include. Returns 400, with the first bad path and the valid names in detail, for: an empty value or empty path; an unknown section; an unknown name; a second segment outside the five objects above; a bare section (fields=hourly, use include); a section missing from the effective include; an uncertainty path without include=uncertainty; a daily.climate path without include=climate.

Will gusts stop a crane lift in Denver?

Response