Climate

Get NWS daily climate reports as GeoJSON.

Returns a GeoJSON FeatureCollection of NWS daily climate reports (CLI): observed high and low, precipitation and snowfall per station, with departures from normal. Each feature's properties bag carries at minimum valid_time; other keys come from the data pipeline and may be added without a sw-api release.

Experimental (x-stability: experimental): excluded from the 90-day breaking-change commitment. This route serves a single product. When the generic feature route ships, it becomes a stable alias of that route with the same shape, or folds into it.

Time window

One selector is used, by precedence date > start+end > hours:

  1. date=YYYY-MM-DD — reports for one day. It must be a real calendar day (2026-02-30 is a 400). When date is set, start/end are not used, so the ordering and span rules below do not apply to them.
  2. start=...&end=... — RFC 3339 instants, both required. Reports are matched by the UTC calendar date of start and end, so both ends are inclusive days (2026-05-01T20:00:00-07:00 is 2026-05-02). start must not be after end, and the span is at most 31 UTC calendar days.
  3. hours=N — rolling lookback, 1 to 168 (7 days). Default 24.

Filters

  • wfo — 3-letter CLI site code, the suffix of the report's AWIPS id (ORD for CLIORD). It names the climate site, which is not always the issuing office's identifier.
  • station — case-insensitive substring of the station name: 1-64 letters, digits, spaces or . , ' ( ) / & -. Other characters (including %, _ and \) are a 400.

Caching

Successful responses carry Cache-Control: max-age=300, stale-while-revalidate=300, public for first-party keys and private for partner keys.

Auth

Standard sw-api Bearer auth applies.

get/v1/climate-reports

Request

  • Base URL: https://api.smarterweather.com
  • URL: https://api.smarterweather.com/v1/climate-reports
  • Auth: HTTP bearer

Query parameters

hoursinteger

Rolling lookback in whole hours (1-168). Lowest-precedence selector.

datestring

ISO-8601 date (YYYY-MM-DD). Highest-precedence selector.

startstring date-time

RFC 3339 window start. Requires end. Matched by its UTC calendar date; must not be after end; at most 31 UTC days before end's date.

endstring date-time

RFC 3339 window end. Requires start. Matched by its UTC calendar date (inclusive).

wfostring

3-letter CLI site code (the AWIPS id suffix, ORD for CLIORD). Upper-cased by the server.

stationstring

Case-insensitive substring of the station name. 1-64 letters, digits, spaces or . , ' ( ) / & -.

Response

GeoJSON FeatureCollection. Empty features array when no reports match.

Changes

No recorded changes to this operation across all 1 revision of this API.