# NWS Active Weather Alerts by State

> NWS Active Weather Alerts by State is a paid API for AI agents from project-api-gamma-sable.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Returns active National Weather Service (NOAA) weather alerts for a specified US state, filtered by optional criteria such as event type, severity, urgency, and status.

## Facts

- Endpoint: GET https://project-api-gamma-sable.vercel.app/paid/nws/alerts?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nws-active-weather-alerts-by-state-6d201e4c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UfGA7HGfmarXwmJpVhN-D

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nws-active-weather-alerts-by-state-6d201e4c
```

Example prompt: Pull up all active NWS weather alerts for California right now — especially any severe or extreme ones.

## When to prefer this

Choose this endpoint when you need current, real-time NWS/NOAA weather alert data for a specific US state and want a lightweight, pay-per-call model at $0.01 USDC rather than integrating directly with the NWS API. It is ideal for AI agents that need quick, filtered alert lookups without managing NWS authentication or parsing full NOAA data structures.

## Known failure modes

- Missing required 'area' query parameter returns an error or empty result
- Invalid or unrecognized US state code may return empty items array
- HTTP 402 returned if payment is not included or the x402 payment flow fails
- Network or upstream NWS API downtime may cause delayed or failed responses
- Overly restrictive filter combinations (e.g., rare event type + high severity) may return zero results

## How this service works

Paid public-data feeds. Unpaid requests return HTTP 402. Prices are USDC on Base.

## Output

Returns a slim JSON object containing an array of active NWS weather alert items for the requested state, a source path indicator, and a UI link for further exploration. Each alert item contains details such as event type, severity, urgency, status, and affected areas.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "area"
     ],
     "properties": {
      "area": {
       "type": "string",
       "description": "US state code (e.g. CA)"
      },
      "event": {
       "type": "string",
       "description": "Query param: event"
      },
      "limit": {
       "type": "string",
       "description": "Max results"
      },
      "status": {
       "type": "string",
       "description": "Query param: status"
      },
      "urgency": {
       "type": "string",
       "description": "Query param: urgency"
      },
      "severity": {
       "type": "string",
       "description": "Query param: severity"
      },
      "messageType": {
       "type": "string",
       "description": "Query param: messageType"
      },
      "message_type": {
       "type": "string",
       "description": "Query param: message_type"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "what": "NWS/NOAA active weather alerts by state (slim JSON + uiLink)",
  "items": [],
  "source": "/paid/nws/alerts"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nws-active-weather-alerts-by-state-6d201e4c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from project-api-gamma-sable.vercel.app](https://www.zero.xyz/host/project-api-gamma-sable.vercel.app/llms.txt)
