# Halowerk Aviation Weather Brief

> Halowerk Aviation Weather Brief is a paid API for AI agents from natur.halowerk.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Fetches a consolidated aviation weather brief for one or more airports, including current METAR observation, terminal forecast (TAF), nearby PIREPs, and active SIGMETs in a single response.

## Facts

- Endpoint: POST https://natur.halowerk.com/v1/aviation-brief
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-aviation-weather-brief-4f87e622
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_te9JScAUzTAKKQS9U6YcH

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-aviation-weather-brief-4f87e622 -d '<json body>'
```

Example prompt: Can you pull the full aviation weather brief for KDEN and KCOS — I need the current METAR with ceiling and winds, the TAF, any active SIGMETs, and nearby pilot reports before I file my flight plan?

## When to prefer this

Choose this endpoint when you need a complete, pre-parsed aviation weather picture for one or more airports in a single API call, rather than querying METAR, TAF, SIGMET, and PIREP sources separately and stitching results together. Particularly valuable for flight planning agents, dispatch systems, or any workflow that needs the derived ceiling value (lowest broken/overcast layer) rather than raw reported layers — saving the agent the parsing logic. Prefer this over raw NOAA feeds when structured, decision-ready output is needed quickly.

## Known failure modes

- Unknown or invalid airport identifier returns an error or empty result
- No active SIGMET or PIREP data returns empty arrays for those fields
- Observation data unavailable for remote or non-reporting stations
- Network timeout or upstream NOAA/aviation data source outage
- Malformed request body (missing airport list) returns 400-level error

## How this service works

Collects the current observation, the terminal forecast, nearby pilot reports and active SIGMETs for the requested airports and returns them in one shape. The observation carries temperature, dewpoint, wind with gusts, visibility, altimeter setting, the cloud layers with their bases, and the derived ceiling — the lowest broken or overcast layer, which is the value that matters and is not the same as the lowest layer reported.

## Output

A unified JSON object per requested airport containing: the current METAR observation (temperature, dewpoint, wind direction and speed with gusts, visibility, altimeter setting, individual cloud layers with bases), the derived ceiling (lowest broken or overcast layer), the terminal area forecast (TAF), nearby pilot reports (PIREPs), and any active SIGMETs affecting the area.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "airports": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 4,
    "minLength": 3
   },
   "maxItems": 12,
   "minItems": 1,
   "description": "ICAO codes, e.g. EDDB, KJFK."
  },
  "include_taf": {
   "type": "boolean",
   "default": true
  },
  "include_pireps": {
   "type": "boolean",
   "default": false,
   "description": "Pilot reports near the field. Adds an upstream call."
  },
  "include_sigmets": {
   "type": "boolean",
   "default": true
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-aviation-weather-brief-4f87e622/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)