# Polyform Weather Travel Risk

> Polyform Weather Travel Risk is a paid API for AI agents from api.polyform.org, paid per call via x402, $0.015/call, status unknown (last checked 2026-10-10).

Returns a LOW/MODERATE/HIGH/SEVERE weather risk judgment for a US coordinate on a given date (within 7 days), with reasons, derived from NWS forecasts and active alerts

## Facts

- Endpoint: GET https://api.polyform.org/v1/weather/travel-risk?utm_source=zero.xyz
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polyform-weather-travel-risk-40ef309b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tpkQG5WYTWuqvv_WqmTp_

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 polyform-weather-travel-risk-40ef309b
```

Example prompt: What's the weather risk level for Nashville, Tennessee (36.1627° N, 86.7816° W) on this coming Saturday? I need LOW/MODERATE/HIGH/SEVERE with the reasons.

## When to prefer this

Use this endpoint when you need a single, pre-interpreted risk verdict (not raw forecast data) for a specific US location and date within the next 7 days. It synthesizes NWS forecast data and active alerts into one actionable signal, saving agents the work of parsing multiple NWS endpoints and applying judgment logic. Prefer it over raw weather APIs when the agent needs to make a go/no-go or risk-tier decision rather than display detailed meteorological data.

## Known failure modes

- Coordinate outside the US — NWS only covers US territories
- Date more than 7 days in the future — beyond supported forecast window
- Invalid or malformed lat/lon values — bad request error
- NWS data temporarily unavailable — upstream outage may cause service errors
- Missing required query parameters (lat, lon, date) — returns validation error

## How this service works

Judgment call for a US coordinate and date (within 7 days): LOW/MODERATE/HIGH/SEVERE weather risk with reasons, built from NWS forecast plus active alerts. JSON.

## Output

A JSON object containing the requested date, a risk classification (LOW, MODERATE, HIGH, or SEVERE), and an array of human-readable reasons explaining the rating, such as active severe thunderstorm watches or high precipitation probability.

## 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",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-08-27",
  "risk": "HIGH",
  "reasons": [
   "Severe Thunderstorm Watch active",
   "80% precip"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polyform-weather-travel-risk-40ef309b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.polyform.org](https://www.zero.xyz/host/api.polyform.org/llms.txt)
