# Halowerk Volcanic Ash Route Checker

> Halowerk Volcanic Ash Route Checker is a paid API for AI agents from natur.halowerk.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-13).

Samples a flight route at a chosen spacing and checks every sample point against active volcanic ash SIGMETs, returning affected segments, ash layer altitudes, SIGMET metadata, and raw text for each intersection.

## Facts

- Endpoint: POST https://natur.halowerk.com/v1/volcanic-ash-route
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-volcanic-ash-route-checker-8e2e5c0f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Rm3-cDLuPCiSdWXaiua4-

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 halowerk-volcanic-ash-route-checker-8e2e5c0f -d '<json body>'
```

Example prompt: Check my planned route — waypoints KSFO, PHNL, PAFA — sampled every 50 nautical miles, and tell me which segments intersect any active volcanic ash SIGMETs, including the ash layer altitudes and which FIR issued the warning.

## When to prefer this

Use this endpoint when you need to programmatically check a specific planned flight route against live volcanic ash SIGMETs, particularly for automated pre-flight dispatch systems, real-time rerouting decisions, or when you need structured segment-level hazard data (ash altitudes, FIR, validity windows) rather than just a general area check. Prefer this over generic SIGMET lookup endpoints when the input is a route (ordered waypoints) and you need to know which specific segments are affected rather than just which SIGMETs exist in a region.

## Known failure modes

- Invalid or missing waypoint list — endpoint requires at least two ordered waypoints
- Sample spacing value out of range or missing — must be a positive numeric interval
- Malformed coordinate data in waypoints — incorrect lat/lon format causes rejection
- SIGMET data source temporarily unavailable — may return empty results or an error if upstream NOTAM/SIGMET feeds are down
- Route too short relative to sample spacing — only one sample generated, limiting coverage
- Payment not provided or insufficient — x402 payment required; missing payment header returns 402

## How this service works

Takes a route as an ordered list of waypoints, samples it at a chosen spacing and tests every sample against the currently active SIGMETs carrying a volcanic ash hazard. For each hit you get the affected segment as a from-to pair of waypoints, the SIGMET issuing centre and flight information region, the validity window, the reported base and top of the ash layer, and the raw text.

## Output

For each route sample point that falls within an active volcanic ash SIGMET, the endpoint returns: the affected segment as a from-to waypoint pair, the SIGMET issuing centre name, the flight information region (FIR), the SIGMET validity start and end times, the base and top altitudes of the volcanic ash layer, and the full raw SIGMET text. If no samples intersect any active ash SIGMETs, the response indicates a clear route.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sample_km": {
   "type": "number",
   "default": 100,
   "maximum": 500,
   "minimum": 10,
   "description": "Spacing at which the route is sampled."
  },
  "waypoints": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "lat",
     "lon"
    ],
    "properties": {
     "lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
     },
     "lon": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
     },
     "name": {
      "type": "string",
      "maxLength": 20
     }
    },
    "additionalProperties": false
   },
   "maxItems": 40,
   "minItems": 2,
   "description": "Ordered route points."
  },
  "proximity_km": {
   "type": "number",
   "default": 150,
   "maximum": 500,
   "minimum": 10,
   "description": "Distance at which a point-only SIGMET counts as nearby."
  },
  "cruise_level_ft": {
   "type": "integer",
   "maximum": 60000,
   "minimum": 0,
   "description": "If given, SIGMETs whose layer does not include this level are reported separately as not affecting you."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-volcanic-ash-route-checker-8e2e5c0f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from natur.halowerk.com](https://www.zero.xyz/host/natur.halowerk.com/llms.txt)