GET /v1/alerts/severe

$0.01realtimetier: utilitycache 300sEngine B — Weather Intelligence

Official National Weather Service active alerts (public domain, attributed) for a lat/lon or two-letter state, combined with our model's forward 48h hazard probabilities (extreme heat, heavy rain, damaging wind). Pass lat+lon or state.

Parameters

Example

curl "https://x402-factory.com/v1/alerts/severe?lat=33.4484&lon=-112.074"

Phoenix — pairs with the captured AZ alert set.

Example response

{
  "data": {
    "active": [
      {
        "event": "Flash Flood Warning",
        "severity": "Severe",
        "headline": "Flash Flood Warning issued July 18 at 3:52PM MST until July 18 at 4:00PM MST by NWS Tucson AZ",
        "onset": "2026-07-18T15:52:00-07:00",
        "expires": "2026-07-18T16:02:00-07:00",
        "source": "NWS"
      },
      {
        "event": "Flash Flood Warning",
        "severity": "Severe",
        "headline": "Flash Flood Warning issued July 18 at 3:46PM MST until July 18 at 5:15PM MST by NWS Flagstaff AZ",
        "onset": "2026-07-18T15:46:00-07:00",
        "expires": "2026-07-18T17:15:00-07:00",
        "source": "NWS"
      },
      {
        "event": "Flood Advisory",
        "severity": "Minor",
        "headline": "Flood Advisory issued July 18 at 3:34PM PDT until July 18 at 4:45PM PDT by NWS Las Vegas NV",
        "onset": "2026-07-18T15:34:00-07:00",
        "expires": "2026-07-18T16:45:00-07:00",
        "source": "NWS"
      },
      {
        "event": "Flash Flood Warning",
        "severity": "Severe",
        "headline": "Flash Flood Warning issued July 18 at 2:42PM MST until July 18 at 5:45PM MST by NWS Flagstaff AZ",
        "onset": "2026-07-18T14:42:00-07:00",
        "expires": "2026-07-18T17:45:00-07:00",
        "source": "NWS"
      },
      {
        "event": "Flood Advisory",
        "severity": "Minor",
        "headline": "Flood Advisory issued July 18 at 2:26PM MST until July 18 at 4:00PM MST by NWS Tucson AZ",
        "onset": "2026-07-18T14:26:00-07:00",
        "expires": "2026-07-18T16:00:00-07:00",
        "source": "NWS"
      },
      {
        "event": "Flash Flood Warning",
        "severity": "Severe",
        "headline": "Flash Flood Warning issued July 18 at 2:21PM MST until July 18 at 4:45PM MST by NWS Tucson AZ",
        "onset": "2026-07-18T14:21:00-07:00",
        "expires": "2026-07-18T16:45:00-07:00",
        "source": "NWS"
      },
      {
        "event": "Flash Flood Warning",
        "severity": "Severe",
        "headline": "Flash Flood Warning issued July 18 at 1:23PM MST until July 18 at 4:30PM MST by NWS Flagstaff AZ",
        "onset": "2026-07-18T13:23:00-07:00",
        "expires": "2026-07-18T16:30:00-07:00",
        "source": "NWS"
      }
    ],
    "model_risk": [
      {
        "hazard": "extreme_heat",
        "window_start": "2026-07-18T12:00:00.000Z",
        "window_end": "2026-07-20T12:00:00.000Z",
        "probability": 0.138
      },
      {
        "hazard": "heavy_rain",
        "window_start": "2026-07-18T12:00:00.000Z",
        "window_end": "2026-07-20T12:00:00.000Z",
        "probability": 0.677
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/alerts/severe",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.970Z",
    "freshness": "realtime",
    "sources": [
      "NWS",
      "stub-model"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/weather.alerts-severe",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "active": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "event": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          },
          "headline": {
            "type": "string"
          },
          "onset": {
            "type": "string"
          },
          "expires": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "const": "NWS"
          }
        },
        "required": [
          "event",
          "severity",
          "headline",
          "onset",
          "expires",
          "source"
        ],
        "additionalProperties": false
      }
    },
    "model_risk": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "hazard": {
            "type": "string"
          },
          "window_start": {
            "type": "string"
          },
          "window_end": {
            "type": "string"
          },
          "probability": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          }
        },
        "required": [
          "hazard",
          "window_start",
          "window_end",
          "probability"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "active",
    "model_risk"
  ],
  "additionalProperties": false
}

The platform wraps every payload in an envelope: { "data": …, "meta": { endpoint, version, generated_at, freshness, sources, request_id, docs, data_mode } }.

Payment (x402)

Unpaid requests receive 402 with payment requirements (accepts). Pay $0.01 in USDC on Base per call via an X-PAYMENT header — see docs.x402.org. With PAYMENT_MODE=disabled (local dev) the endpoint is open.

Errors