# Aviation Weather METAR & TAF by ICAO

> Aviation Weather METAR & TAF by ICAO is a paid API for AI agents from api.healthtravel-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns current METAR observation and TAF forecast for any airport identified by its 4-letter ICAO code, sourced from aviationweather.gov

## Facts

- Endpoint: GET https://api.healthtravel-api.workers.dev/api/travel/aviationweather-metar-taf?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aviation-weather-metar-taf-by-icao-cdaf57af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2iLCbsXSnstlCOWRx2jcy

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 aviation-weather-metar-taf-by-icao-cdaf57af
```

Example prompt: What are the current METAR conditions and TAF forecast for JFK airport — give me wind, visibility, cloud cover, and flight category?

## When to prefer this

Use this endpoint when you need official, structured aviation weather (METAR and TAF) for any ICAO-coded airport worldwide, without signing up for an account or managing API keys. Prefer this over raw web scraping or consumer weather APIs when you need aviation-standard data like flight category (VFR/IFR/MVFR/LIFR), altimeter settings in hPa, cloud bases in feet, or TAF forecast periods. Pay-per-call at $0.002 USDC means no subscription overhead for low-frequency lookups.

## Known failure modes

- Invalid or unknown ICAO code returns an error — ICAO codes are 4 letters and must match a real station
- Airport has no active METAR reporting (remote or non-reporting station) — partial or empty response
- TAF not available for small or non-towered airports — metar may be present but taf object absent
- Network or upstream aviationweather.gov outage — service error returned
- Stale data if the upstream feed is delayed — checkedAt vs observedAt timestamps may differ significantly

## How this service works

Current airport weather from NOAA Aviation Weather Center: latest METAR (observed temperature, dewpoint, wind, visibility, altimeter, flight category) and the TAF forecast text for a 4-letter ICAO airport code. Raw text is included alongside the parsed fields.

## Output

Returns a JSON object with the airport's ICAO code and name, a decoded METAR object (raw text, temperature, dewpoint, wind direction and speed, altimeter, visibility, cloud layers, and flight category), a TAF object (raw text, issue time, valid from/to times), source URL, and timestamps for when the data was checked and observed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "icao"
     ],
     "properties": {
      "icao": {
       "type": "string",
       "description": "4-letter ICAO airport code, e.g. KJFK, EGLL, LFPG"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "taf": {
   "raw": "TAF KJFK 230830Z 2308/2412 01010KT P6SM SKC FM231500 03010KT P6SM SKC FM232300 03007KT P6SM FEW250",
   "validTo": "2026-10-24T12:00:00.000Z",
   "issueTime": "2026-10-23T08:30:00.000Z",
   "validFrom": "2026-10-23T08:00:00.000Z"
  },
  "icao": "KJFK",
  "name": "New York/JF Kennedy Intl, NY, US",
  "metar": {
   "raw": "METAR KJFK 230851Z 01006KT 10SM FEW250 10/03 A3023 RMK AO2 SLP235 T01000028 53020",
   "clouds": [
    {
     "base": 25000,
     "cover": "FEW"
    }
   ],
   "dewpointC": 2.8,
   "windDirDeg": 10,
   "altimeterHpa": 1023.8,
   "temperatureC": 10,
   "windSpeedKts": 6,
   "flightCategory": "VFR",
   "visibilityStatuteMi": "10+"
  },
  "source": "https://aviationweather.gov/api/data/metar?ids=KJFK",
  "checkedAt": "2026-10-23T09:36:43.892Z",
  "observedAt": "2026-10-23T08:51:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aviation-weather-metar-taf-by-icao-cdaf57af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.healthtravel-api.workers.dev](https://www.zero.xyz/host/api.healthtravel-api.workers.dev/llms.txt)