number
-90 to 90. Latitude.MoreLess
Must be provided together with lon. Mutually exclusive with zip and location.
number
-180 to 180. Longitude.MoreLess
Must be provided together with lat. Mutually exclusive with zip and location.
string
5-digit US ZIP code.MoreLess
Mutually exclusive with lat/lon and location.
string
Unit system for numeric response fields.MoreLess
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.
integer
1 to 14. Number of days for the daily forecast.
string
Column preset for hourly and daily rows.MoreLess
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.
integer
1 to 24. Keep one hourly row every hourly_step hours (by whole-hour offset from hourly[0].time), from hourly_step_from on.MoreLess
1 (default) keeps every row. Out of range or non-integer is a 400.
integer
0 to 168. Offset in hours from hourly[0].time below which every hourly row is kept; hourly_step applies from this offset on.MoreLess
0 (default) thins from the first row. A no-op when hourly_step is 1. Out of range is a 400.
string
Sparse fieldset for hourly and daily rows:MoreLess
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.