v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Environment

Active NWS hazard alerts

Return the set of NWS hazard alerts that are currently active (effective now, not yet expired). NWS issues ~500-1500 active alerts at any given moment across the United States and its territories: tornado warnings, flood warnings, heat advisories, coastal-flood watches, winter-storm warnings, marine warnings, and more. Zone-based alerts carry a null geometry and reference affected_zones; short-fuse convective warnings (Tornado, Severe Thunderstorm, Flash Flood, Special Marine) carry a polygon. All timestamps are ISO 8601 with the issuing office's local offset. Attribution: NOAA National Weather Service (api.weather.gov).

get/api/v1/weather/nws/alerts/active

Query parameters

areastring nullable

Two-letter state or territory code (e.g. NY, CA, PR). Filters to alerts whose affected_zones lie within the area.

Two-letter state or territory code (e.g. NY, CA, PR). Filters to alerts whose affected_zones lie within the area.

region_typestring nullable

One of land or marine. Restricts to land-zone alerts or marine-zone alerts respectively.

One of land or marine. Restricts to land-zone alerts or marine-zone alerts respectively.

zonestring nullable

NWS zone ID to filter by (e.g. NYZ071). Returns alerts that list this zone in affected_zones.

NWS zone ID to filter by (e.g. NYZ071). Returns alerts that list this zone in affected_zones.

eventstring nullable

Filter by event label (e.g. Tornado Warning, Frost Advisory). Use /alert-types to discover valid labels.

Filter by event label (e.g. Tornado Warning, Frost Advisory). Use /alert-types to discover valid labels.

severitystring nullable

Filter by severity: Extreme, Severe, Moderate, Minor, Unknown.

Filter by severity: Extreme, Severe, Moderate, Minor, Unknown.

urgencystring nullable

Filter by urgency: Immediate, Expected, Future, Past, Unknown.

Filter by urgency: Immediate, Expected, Future, Past, Unknown.

certaintystring nullable

Filter by certainty: Observed, Likely, Possible, Unlikely, Unknown.

Filter by certainty: Observed, Likely, Possible, Unlikely, Unknown.

limitinteger

Maximum number of alerts to return (NWS caps at 500).

Maximum number of alerts to return (NWS caps at 500).

Response

List of active NWS alerts with full CAP metadata.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}