# x402 Hail Report

> x402 Hail Report is a paid API for AI agents from hail.kagurazaka.dev, paid per call via x402, $1/call, status unknown (last checked 2026-11-02).

Generates a comprehensive one-page hail report for a US address and date, including radar estimates, hail map, spotter reports, and NOAA Storm Events, returned as a shareable private link.

## Facts

- Endpoint: POST https://hail.kagurazaka.dev/v1/hail/report?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-hail-report-34512be5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mHahK6_pGllcy7xsub6YI

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 x402-hail-report-34512be5 -d '<json body>'
```

Example prompt: Can you pull a hail report for 200 W 2nd St, Wichita, KS 67202 for May 16, 2025? I need the radar estimates, spotter reports, and a shareable link I can send to an insurance adjuster.

## When to prefer this

Choose this endpoint when you need a complete, shareable hail verification report for a specific US address and date — particularly for insurance claims, contractor inspections, or homeowner documentation. It aggregates NOAA MRMS radar estimates, NEXRAD signatures, spotter reports, and Storm Events into a single human-readable report link, making it superior to raw NOAA data lookups when a presentable artifact is required. Best for single-event, single-address queries where you need both data and a deliverable link.

## Known failure modes

- Address not found or outside the US — not charged, returns error indicating unmatched address
- Date before 2020-10-14 — outside supported historical range
- No radar coverage for the requested date/location — may return 'no_hail' verdict with coverage flag false
- Invalid date format — returns validation error
- Missing both address and lat/lon — returns schema validation error

## How this service works

A one-page hail report for a US address and date to share with a homeowner, adjuster or contractor: verdict, largest radar hail estimates by distance, a map of hail sizes within 10 miles, radar hail signatures in time order (when it fell), spotter reports, and NOAA's final Storm Events record with damage notes when published. Returns a private link valid for 1 year. Not found addresses are not charged.

## Output

A JSON response containing a hail verdict (e.g. 'hail_likely'), NOAA MRMS radar hail size estimates at the location and within 1, 3, 5, and 10 miles, radar NEXRAD signatures with timestamps, local spotter reports with sizes and distances, NOAA Storm Events damage notes when available, and a private shareable report URL valid for one year.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "description": "latitude, instead of address"
  },
  "lon": {
   "type": "number",
   "description": "longitude, instead of address"
  },
  "date": {
   "type": "string",
   "description": "the day of the storm, YYYY-MM-DD, 2020-10-14 or later; covers 12 UTC that day to 12 UTC the next (morning to morning in the US)"
  },
  "address": {
   "type": "string",
   "description": "a US street address on one line, such as 200 W 2nd St, Wichita, KS 67202"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "check": {
   "date": "2025-05-16",
   "notes": [
    "Radar estimates (MESH) are not ground observations; ..."
   ],
   "verdict": "hail_likely",
   "location": {
    "lat": 37.1,
    "lon": -88.96,
    "input": "37.1,-88.96",
    "matched": "37.1, -88.96",
    "geocoder": "none"
   },
   "window_utc": [
    "2025-05-16T12:00:00Z",
    "2025-05-17T12:00:00Z"
   ],
   "verdict_rule": "radar estimate of 0.75 in or more within 3 miles",
   "radar_estimate": {
    "source": "NOAA MRMS Maximum Estimated Size of Hail (MESH), 24-hour maximum, 0.01-degree grid",
    "covered": true,
    "max_size_in": {
     "at_location": 1.08,
     "within_1_mi": 1.28,
     "within_3_mi": 2.19,
     "within_5_mi": 2.54,
     "within_10_mi": 2.54
    }
   },
   "spotter_reports": [
    {
     "lat": 37.1,
     "lon": -88.97,
     "state": "KY",
     "county": "Ballard",
     "comment": "Late LSR. At least two public reports/photos of approximately CD/DVD sized hail in Ballard County... (PAH)",
     "size_in": 4.5,
     "location": "2 NNE La Center",
     "time_utc": "2025-05-16T21:45:00Z",
     "distance_mi": 0.6
    }
   ],
   "radar_signatures": {
    "count": 8,
    "source": "NOAA NEXRAD Level III hail signatures (NCEI SWDI nx3hail)",
    "last_utc": "2025-05-17T00:18:39Z",
    "available": true,
    "first_utc": "2025-05-16T21:40:21Z",
    "within_mi": 5,
    "max_size_in": 4
   }
  },
  "verdict": "hail_likely",
  "report_url": "https://hail.kagurazaka.dev/r/3q2-7wHFZkS8bTfY1pAqLg",
  "expires_utc": "2026-11-01T00:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-hail-report-34512be5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hail.kagurazaka.dev](https://www.zero.xyz/host/hail.kagurazaka.dev/llms.txt)