{"uid":"cap_Rm3-cDLuPCiSdWXaiua4-","slug":"halowerk-volcanic-ash-route-checker-8e2e5c0f","name":"Halowerk Volcanic Ash Route Checker","description":"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.","url":"https://natur.halowerk.com/v1/volcanic-ash-route","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zsOv3iR96KX9xNERMuWdE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-flight volcanic ash clearance check","prompt":"I'm filing a flight plan from KATL to EGLL via CYQX and EINN. Can you sample the route every 100 nautical miles and check each point against active volcanic ash SIGMETs? I need to know exactly which segments are affected and the altitude bands of any ash layers."},{"title":"Dispatch go/no-go volcanic ash decision","prompt":"Our dispatcher needs to know if the route OMDB → VABB → WSSS has any volcanic ash SIGMET conflicts right now. Sample it every 75 nautical miles and return the SIGMET issuing centres, validity windows, and ash top/base altitudes for any hits."},{"title":"Real-time ash avoidance rerouting","prompt":"We're looking at an alternate route — waypoints RJTT, PANC, KSEA — sampled every 60 nautical miles. Run it against current volcanic ash SIGMETs and show me which segments are affected so we can decide whether to reroute."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:40:12.915Z","isFirstParty":false}