Storms

Get active storm-cell tracks as GeoJSON.

Returns a GeoJSON FeatureCollection of active storm-cell tracks aggregated from NEXRAD radar products. Each feature carries cell metadata (id, site, scan / valid times) plus an optional impact section listing affected cities and population when detailed=true is requested.

Site filter

site is an optional NEXRAD radar site code. The storm-track pipeline keys on the 3-letter site code (e.g., LOT, TLX); a 4-letter ICAO (e.g., KLOT) is also accepted. Empty site returns one feature per active radar cell across the network; setting site filters to that radar. Site IDs are uppercased server-side.

Detailed mode

detailed=true adds each cell's impact payload (properties.impact.affected_cities, properties.impact.affected_population). Detailed responses are larger and use a 60s server-side cache; the all-sites all-cells path uses a 30s cache.

Schema stability

The GeoJSON type, geometry, and properties.cell_id / properties.site_id / properties.scan_time / properties.valid_time fields are stable. Other property-bag keys (impact.*, category, etc.) are documented as forward-compat: the data pipeline may add new keys without a sw-api release, so consumers should treat unknown keys as opaque additive data.

Caching

Successful responses carry Cache-Control: public, max-age=30, stale-while-revalidate=30. Edge cache key includes the full query string (site and detailed) so each variant gets its own TTL.

Auth

Standard sw-api Bearer auth applies.

get/v1/storm-tracks

Request

  • Base URL: https://api.smarterweather.com
  • URL: https://api.smarterweather.com/v1/storm-tracks
  • Auth: HTTP bearer

Query parameters

sitestring

Optional NEXRAD radar site code. The storm-track pipeline keys on the 3-letter site code (e.g., LOT); a 4-letter ICAO (e.g., KLOT) is also accepted. Empty returns active cells across all radar sites.

detailedboolean

When true, includes each cell's impact payload (affected cities + populations). When omitted or false, returns the lightweight cell-only response.

Response

GeoJSON FeatureCollection. Empty features array when no active cells are tracked (this is a 200, not a 404 — a 200 with {"features": []} is the canonical "no active storms" response).

Changes

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