# AviationAPIs TAF (Terminal Aerodrome Forecast)

> AviationAPIs TAF (Terminal Aerodrome Forecast) is a paid API for AI agents from aviationapis.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns a parsed Terminal Aerodrome Forecast (TAF) for any airport given its ICAO code, including wind, visibility, cloud cover, and forecast periods.

## Facts

- Endpoint: POST https://aviationapis.com/taf
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aviationapis-taf-terminal-aerodrome-forecast-ae201c1f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_D1m7RXCOMNoj0HEFWDxjt

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 aviationapis-taf-terminal-aerodrome-forecast-ae201c1f -d '<json body>'
```

Example prompt: What's the terminal aerodrome forecast for London Heathrow (EGLL) right now — I need wind speed, direction, visibility, and cloud cover broken down by forecast period.

## When to prefer this

Use this endpoint when you need structured, parsed TAF data for a specific airport identified by its ICAO code, especially within an AI agent workflow that pays per call via x402/USDC. Prefer this over scraping aviation weather sites or calling NOAA APIs directly when you need clean JSON output with decoded forecast periods ready for downstream logic.

## Known failure modes

- Invalid or non-existent ICAO code returns an error — must be exactly 4 letters
- Airport has no TAF issued (e.g. small GA airports) — may return empty or error
- Payment failure via x402 if USDC wallet is not funded or x402 header is missing
- Network timeout if upstream aviation weather data source is unavailable
- Stale TAF if the issuing met office has not updated recently

## How this service works

Pay-per-call aviation data APIs for AI agents, settled in USDC via the x402 protocol.

## Output

Returns structured TAF data including the raw TAF string, airport name, ICAO code, issuance time, validity window, and an array of forecast periods each containing wind (speed, direction, gust), visibility in statute miles, cloud layers (cover type and base altitude in feet), and any weather phenomena. Also includes fetch timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "icao": {
   "type": "string",
   "pattern": "^[A-Za-z]{4}$",
   "description": "4-letter ICAO airport code (e.g. 'KSFO', 'EGLL', 'RJTT')"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": "TAF EGLL 021700Z 0218/0400 24012KT 9999 BKN025",
  "icao": "EGLL",
  "name": "London Heathrow",
  "periods": [
   {
    "to": "2026-06-03T06:00:00.000Z",
    "from": "2026-06-02T18:00:00.000Z",
    "wind": {
     "gust_kt": null,
     "speed_kt": 12,
     "direction_deg": 240
    },
    "change": null,
    "clouds": [
     {
      "cover": "BKN",
      "base_ft": 2500
     }
    ],
    "weather": null,
    "visibility_sm": 6
   }
  ],
  "valid_to": "2026-06-04T00:00:00.000Z",
  "issued_at": "2026-06-02T17:00:00Z",
  "fetched_at": "2026-06-02T18:58:11.000Z",
  "valid_from": "2026-06-02T18:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aviationapis-taf-terminal-aerodrome-forecast-ae201c1f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aviationapis.com](https://www.zero.xyz/host/aviationapis.com/llms.txt)