Storms

Get NWS climate-record events as GeoJSON.

Returns a GeoJSON FeatureCollection of NWS climate-record events (record high / low temperatures, daily precipitation records, etc.) within the requested time window. Each feature's properties bag carries at minimum valid_time plus the event-type-specific payload from the data pipeline. As with /v1/storm-reports, additional properties keys may appear without a sw-api release.

Time window

Three selectors choose the window:

  1. date=YYYY-MM-DD — single-day window
  2. start=...&end=... — explicit RFC3339 window (both required together)
  3. hours=N — rolling lookback, applied from 1 to 720 (30 days).

If several are set, date wins, then start+end, then hours; every selector that is set must still be well formed. With none, the last 24 hours.

Filters

  • wfo — 3-letter NWS Weather Forecast Office identifier.
  • type — alphabetic record-event code (2-16 characters, e.g. high, low, precip, snow).

Caching

Successful responses carry Cache-Control: public, max-age=60, stale-while-revalidate=60.

Auth

Standard sw-api Bearer auth applies.

get/v1/record-events

Request

  • Base URL: https://api.smarterweather.com
  • URL: https://api.smarterweather.com/v1/record-events
  • Auth: HTTP bearer

Query parameters

hoursinteger

Rolling lookback window in whole hours, applied from 1 to 720 (30 days). Lowest precedence among the time-window selectors.

datestring

ISO-8601 date (YYYY-MM-DD). Highest-precedence time-window selector; trumps start+end and hours when supplied.

startstring date-time

RFC3339 timestamp marking the start of the window. Must be supplied together with end.

endstring date-time

RFC3339 timestamp marking the end of the window. Must be supplied together with start.

wfostring

3-letter NWS Weather Forecast Office identifier.

typestring

Alphabetic record-event code (e.g. high, low, precip, snow). 2-16 characters.

Response

GeoJSON FeatureCollection. Empty features array when no record events match the window + filters.

Changes

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