# Aviation Weather Center METAR and TAF API

> NOAA Aviation Weather Center: live METAR observations, TAF forecasts and airport data by ICAO code

- Vendor: `aviationweathercentermetarandt` · version 1.0 · category Weather · tags metar api, taf api, aviation weather api, airport weather api, noaa aviation api, icao airport api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/aviationweathercentermetarandt
- This document: https://apiclay.com/docs/aviationweathercentermetarandt.md
- OpenAPI 3.1: https://apiclay.com/api/aviationweathercentermetarandt/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `aviationweathercentermetarandt`
- Updated: 2026-11-18

## About

## Aviation Weather Center METAR and TAF API

The data API of the NOAA Aviation Weather Center: current and recent METAR observations for any airport by ICAO code, with temperature, dew point, wind, gusts, visibility, pressure, cloud layers, flight category and the raw report; TAF terminal forecasts with each forecast period; and airport records with names, IATA and FAA codes, location, elevation, runways, communication frequencies and services.

Data comes from **aviationweather.gov** (https://aviationweather.gov). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/metar?ids=KJFK,EGLL&amp;hours=2`, `/taf?ids=KJFK`, `/airport?ids=KJFK`.

### Routes

#### GET `/metar` - METAR observations
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| ids | query | string | yes | Comma-separated ICAO codes, e.g. `KJFK,EGLL`. |
| hours | query | number | no | Hours back to include, e.g. `2`; latest only without it. |

Returns: Array: `icaoId`, `name`, `obsTime`, `reportTime`, `temp`, `dewp`, `wdir`, `wspd`, `wgst`, `visib`, `altim`, `slp`, `wxString`, `clouds` (`cover`, `base`), `fltCat`, `lat`, `lon`, `elev`, `rawOb`.

#### GET `/taf` - TAF forecasts
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| ids | query | string | yes | Comma-separated ICAO codes, e.g. `KJFK`. |

Returns: Array: `icaoId`, `issueTime`, `validTimeFrom`, `validTimeTo`, `rawTAF`, `fcsts` (each period with `timeFrom`, `timeTo`, `fcstChange`, `wdir`, `wspd`, `wgst`, `visib`, `wxString`, `clouds`).

#### GET `/airport` - Airports
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| ids | query | string | yes | Comma-separated ICAO codes, e.g. `KJFK`. |

Returns: Array: `icaoId`, `iataId`, `faaId`, `name`, `state`, `country`, `lat`, `lon`, `elev`, `magdec`, `runways`, `freqs`, `services`, `tower`, `beacon`.

### Caveats

- For flight planning use official briefings: this data has no guarantee of timeliness or completeness.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by aviationweather.gov.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /metar — METAR observations
- Gateway: `GET https://api.apiclay.com/v1/api/aviationweathercentermetarandt/metar`
- Public query params: `ids` (string, required), `hours` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /taf — TAF forecasts
- Gateway: `GET https://api.apiclay.com/v1/api/aviationweathercentermetarandt/taf`
- Public query params: `ids` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /airport — Airports
- Gateway: `GET https://api.apiclay.com/v1/api/aviationweathercentermetarandt/airport`
- Public query params: `ids` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/aviationweathercentermetarandt/metar?ids=<ids>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
