# Eckari US Weather Alerts

> Eckari US Weather Alerts is a paid API for AI agents from api.eckari.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Returns active NWS weather watches, warnings, and advisories for a US location (lat/lon or state code) in real time

## Facts

- Endpoint: GET https://api.eckari.com/v1/weather/us/alerts?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eckari-us-weather-alerts-fbe32e28
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LTPQwepSBPV-BvklEfK4p

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 eckari-us-weather-alerts-fbe32e28
```

Example prompt: Are there any active NWS weather warnings or watches right now for Washington DC — coordinates 38.8977, -77.0365 — and if so, give me the full NWS narrative so I understand what's happening?

## When to prefer this

Use this endpoint when you need real-time, authoritative NWS weather alert data for a specific US coordinate or state before making operational decisions like dispatching personnel, routing vehicles, or scheduling outdoor activities. It is the right choice over general weather APIs when you specifically need official government watches, warnings, and advisories (not forecasts or current conditions). Prefer it over scraping NWS directly for its structured, agent-friendly JSON response and pagination support. Use detail=full when you need the human-readable NWS narrative for end-user communication.

## Known failure modes

- Missing both lat/lon and state parameter returns a validation error — one of the two forms is required
- Invalid state code (not exactly two letters) is rejected by schema validation
- Coordinates outside valid ranges (lat >90/<-90, lon >180/<-180) are rejected
- NWS upstream unavailability may cause a service error — response is read live at request time
- Empty items list is not an error — it means no active alerts exist for that location

## How this service works

Active National Weather Service watches, warnings and advisories for a US coordinate or a two-letter state or marine area code - event, severity, certainty, urgency, headline, affected areas and zone codes, and effective/onset/expiry times in UTC. Read at request time, so an empty list means nothing is active. The 5 newest come back by default; detail=full adds the NWS narrative. Use when: Decide whether an active US weather warning affects a location before dispatching or travelling.

## Output

Returns a paginated list of active NWS alert objects, each containing event type, severity, certainty, urgency, headline, affected area names, zone codes, and effective/onset/expiry timestamps in UTC. The page metadata shows total active alerts, how many were returned, and whether more exist. With detail=full, each alert also includes the multi-paragraph NWS narrative description (truncated at 2000 chars with a truncation flag) and protective-action instruction text. An empty items array means no active alerts.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "anyOf": [
      {
       "required": [
        "lat",
        "lon"
       ]
      },
      {
       "required": [
        "state"
       ]
      }
     ],
     "properties": {
      "lat": {
       "type": "number",
       "maximum": 90,
       "minimum": -90,
       "description": "Latitude in decimal degrees (WGS84). Provide lat and lon together, or provide state."
      },
      "lon": {
       "type": "number",
       "maximum": 180,
       "minimum": -180,
       "description": "Longitude in decimal degrees (WGS84). Provide lat and lon together, or provide state."
      },
      "limit": {
       "type": "integer",
       "default": 5,
       "maximum": 50,
       "minimum": 1,
       "description": "Maximum number of active alerts to return, in the order NWS returns them. The default of 5 keeps the answer compact - a busy state can have dozens of active alerts, each covering tens of zones - and page.total always reports how many are active, so nothing is hidden."
      },
      "state": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Two-letter US state, territory or NWS marine area code such as CA / TX / PR. Alternative to lat and lon; one of the two forms is required."
      },
      "detail": {
       "enum": [
        "compact",
        "full"
       ],
       "type": "string",
       "default": "compact",
       "description": "compact (default) returns the fields an agent decides on. full adds the two NWS narrative members - description (the multi-paragraph WHAT/WHERE/WHEN/IMPACTS text, truncated at 2000 characters with description_truncated set) and instruction (the protective-action text) - which are written for a human reader and are several times the size of the rest of the alert."
      },
      "offset": {
       "type": "integer",
       "default": 0,
       "minimum": 0,
       "description": "Zero-based index of the first alert to return, for paging through the active set with limit. The whole active set is read in one upstream request and returned in th
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "page": {
    "limit": 5,
    "total": 0,
    "offset": 0,
    "has_more": false,
    "returned": 0,
    "next_offset": null
   },
   "items": [],
   "query": {
    "lat": 38.8977,
    "lon": -77.0365,
    "state": null,
    "detail": "compact"
   }
  },
  "meta": {
   "source": "nws",
   "version": "4.0.0",
   "freshness": "live",
   "capability": "weather.us.alerts"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eckari-us-weather-alerts-fbe32e28/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.eckari.com](https://www.zero.xyz/host/api.eckari.com/llms.txt)