# US Weather Alerts by State (NWS)

> US Weather Alerts by State (NWS) is a paid API for AI agents from agent-evidence.thx93.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-22).

Returns active National Weather Service alerts for a given US state, including event type, affected area, severity level, and official instructions.

## Facts

- Endpoint: POST https://agent-evidence.thx93.dev/v1/weather/alerts?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-weather-alerts-by-state-nws-e9586724
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EHUATlM7c-fMzXX1kMewV

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 us-weather-alerts-by-state-nws-e9586724 -d '<json body>'
```

Example prompt: Are there any active weather alerts in Florida right now? I need to know the event type, which areas are affected, severity, and any official instructions.

## When to prefer this

Choose this endpoint when you need real-time, official NWS weather alert data scoped to a specific US state, including structured severity and instructions. Prefer this over generic weather APIs when you need official emergency alerts rather than forecasts or current conditions, or when you need actionable public-safety instructions tied to a specific weather event.

## Known failure modes

- Invalid or unrecognized state code returns empty alerts array or error
- No active alerts for a state returns count of 0 with empty alerts array
- NWS data source unavailable may cause upstream fetch failure
- Malformed request body (missing required fields) returns 4xx error
- Payment failure (x402) returns 402 Payment Required before processing

## How this service works

Verify a claim or fact check a statement against public web sources: send a question and up to 5 URLs, get cited evidence - passages that support, contradict or fail to settle it. Claim verification with a citation for every excerpt: source URL, retrieval time, content hash. Never charges when nothing is retrieved. Free to evaluate: the `sample` tool returns one real response at no cost, so you can judge the output before paying for your own question.

## Output

Returns a JSON object containing the state code, total alert count, and an array of active alerts each with: event name (e.g. Flood Advisory), affected area name, severity level (e.g. Minor, Moderate, Severe, Extreme), a description of the event, and official NWS instructions for the public.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "state": "CA",
  "alerts": [
   {
    "area": "San Francisco",
    "event": "Flood Advisory",
    "severity": "Minor",
    "description": "Minor flooding expected.",
    "instructions": "Do not drive through flooded roadways."
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-weather-alerts-by-state-nws-e9586724/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-evidence.thx93.dev](https://www.zero.xyz/host/agent-evidence.thx93.dev/llms.txt)