# NWS Active Alerts by US State

> NWS Active Alerts by US State is a paid API for AI agents from foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns current National Weather Service active alerts for a specified US state or territory, including severity, urgency, expiry, and official identifiers.

## Facts

- Endpoint: POST https://foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/v2/official/nws-active-alerts
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nws-active-alerts-by-us-state-1fa35495
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-2jvgieqb7vF5RGs3OXj-

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-alerts-by-us-state-1fa35495 -d '<json body>'
```

Example prompt: What are the current National Weather Service active alerts for Texas — show me up to 10 of them with severity and urgency details?

## When to prefer this

Choose this endpoint when you need current, authoritative NWS weather alert data for a specific US state or territory in real time, especially for safety-critical decisions, logistics, travel planning, or automated monitoring workflows. It normalizes raw NWS data into a consistent schema with freshness metadata and attribution, making it more agent-friendly than calling the NWS API directly. Prefer this over general weather forecast endpoints when the specific need is official government-issued alerts (warnings, watches, advisories) rather than forecast conditions.

## Known failure modes

- Invalid or unsupported state/territory code returns a validation error
- NWS upstream API unavailability may result in stale or empty results
- Result count capped at 20; more alerts may exist but won't be returned
- No alerts active for a state returns an empty normalizedResult array
- Payment failure (x402) blocks access before any query is made

## How this service works

Pay-per-request evidence and data tools: CSV validation and reconciliation, DNS/email configuration evidence, and bounded official weather, earthquake, vehicle, company and study records. Exact USDC prices, explicit JSON contracts and source provenance. No mailbox, ownership, medical or safety guarantees.

## Output

Returns a JSON object containing the queried state/territory, a list of normalized active NWS alert records (up to the requested limit) with fields for severity, urgency, expiry, and official source identifiers, plus freshness metadata including retrieval timestamp, cache age, provenance/attribution details, and a link to the upstream NWS API source.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "area": {
   "enum": [
    "AL",
    "AK",
    "AZ",
    "AR",
    "CA",
    "CO",
    "CT",
    "DE",
    "FL",
    "GA",
    "HI",
    "ID",
    "IL",
    "IN",
    "IA",
    "KS",
    "KY",
    "LA",
    "ME",
    "MD",
    "MA",
    "MI",
    "MN",
    "MS",
    "MO",
    "MT",
    "NE",
    "NV",
    "NH",
    "NJ",
    "NM",
    "NY",
    "NC",
    "ND",
    "OH",
    "OK",
    "OR",
    "PA",
    "RI",
    "SC",
    "SD",
    "TN",
    "TX",
    "UT",
    "VT",
    "VA",
    "WA",
    "WV",
    "WI",
    "WY",
    "DC",
    "PR",
    "VI",
    "GU",
    "AS",
    "MP"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 20,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "route": "nws-active-alerts",
  "result": {
   "query": {
    "area": "AK",
    "limit": 5
   },
   "source": "National Weather Service",
   "freshness": {
    "state": "CURRENT_RETRIEVAL",
    "retrievedAt": "2026-09-06T00:00:00Z",
    "cacheAgeSeconds": 0,
    "maximumCacheSeconds": 30,
    "recordAgeIsNotRetrievalAge": true
   },
   "sourceUrl": "https://api.weather.gov",
   "observedAt": "2026-09-06T00:00:00Z",
   "provenance": {
    "license": "Open data free for any purpose; attribution and non-endorsement required",
    "termsUrl": "https://www.weather.gov/disclaimer",
    "truncated": false,
    "attribution": "NOAA / National Weather Service; normalized by Foundry; no endorsement",
    "limitations": [
     "Synthetic example only; identifiers and null values illustrate fields, not a live observation."
    ],
    "modifications": "Selected factual fields, normalized names and bounded result count; no source ownership claimed.",
    "upstreamCalls": 1,
    "documentationUrl": "https://www.weather.gov/documentation/services-web-api"
   },
   "sourceUpdatedAt": null,
   "normalizedResult": [
    {
     "id": "illustrative-record",
     "ends": null,
     "event": null,
     "onset": null,
     "status": null,
     "expires": null,
     "urgency": null,
     "areaDesc": null,
     "headline": null,
     "severity": null,
     "certainty": null,
     "effective": null
    }
   ],
   "sourceProcessedAt": null,
   "rawSourceIdentifiers": []
  },
  "observed_at": "2026-09-06T00:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nws-active-alerts-by-us-state-1fa35495/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev](https://www.zero.xyz/host/foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/llms.txt)