---
title: "TAFs"
method: GET
path: "/api/data/taf"
tags: ["Weather Data"]
---

# TAFs

`GET /api/data/taf`

## Request

- Base URL: `https://aviationweather.gov` (the document declares no server; this is the origin it was published from)
- URL: `https://aviationweather.gov/api/data/taf`
- Auth: none declared

Decoded Terminal Aerodrome Forecast products. Station identifiers or a bounding box is required.

## Query parameters

- `ids` string
- `bbox` string
- `format` 'raw' | 'json' | 'geojson' | 'xml' | 'iwxxm'
- `metar` boolean
- `time` 'valid' | 'issue'
- `date` string

## Response `200`

successful operation

- TAFproperties[]
  - `icaoId` string: ICAO identifier
  - `dbPopTime` string: The time the product was received (yyyy-mm-dd hh:mm:ss.sssZ)
  - `bulletinTime` string: The official time of the bulletin (yyyy-mm-dd hh:mm:ss.sssZ)
  - `issueTime` string: The time the product was issued (yyyy-mm-dd hh:mm:ss.sssZ)
  - `validTimeFrom` integer: The time the period of validity starts (unix timestamp)
  - `validTimeTo` integer: The time the period of validity ends (unix timestamp)
  - `rawTAF` string: The raw text of the TAF
  - `mostRecent` integer: Most recent flag (1=most recent, 0=not)
  - `remarks` string: Any additional remarks for TAF
  - `lat` number: Latitude of site in degrees
  - `lon` number: Longitude of site in degrees
  - `elev` integer: Elevation of site in meters
  - `prior` integer: Priority of site for progressive disclosure (0-9)
  - `name` string: Full name of the site
  - `fcsts` object[]: Each forecast within the TAF
    - `timeFrom` integer, required: The time the forecast validity starts (UNIX timestamp)
    - `timeTo` integer, required: The time the forecast validity ends (UNIX timestamp)
    - `timeBec` integer, required: The time the forecast transition ends BECMG 0501/0503 - last time in sequence (UNIX timestamp)
    - `fcstChange` 'TEMPO' | 'FM' | 'BECMG' | 'PROB', required: Change type for each forecast
    - `probability` integer, required: The probability of occurrence from PROB30 change group
    - `wdir` union, required: Wind direction in degrees of VRB for variable winds
      - integer
      - string
    - `wspd` integer, required: Wind speed in knots
    - `wgst` integer, required: Wind gusts in knots
    - `wshearHgt` integer, required: Wind shear layer top in feet
    - `wshearDir` integer, required: Wind direction at top of wind shear layer in degrees
    - `wshearSpd` integer, required: Wind speed at top of wind shear layer in knots
    - `visib` union, required: Visibility in statute miles, 6+ is greater than 6 sm
      - number
      - string
    - `altim` number, required: Altimeter setting in hectoPascal
    - `vertVis` integer, required: Vertical visibility in feet
    - `wxString` string, required: Encoded present weather string
    - `notDecoded` string, required: Any text that wasn't decoded
    - `clouds` object[], required: Clouds
      - `cover` 'CLR' | 'CAVOK' | 'FEW' | 'SCT' | 'BKN' | 'OVC' | 'OVX', required: Cover coverage
      - `base` integer, required: Cloud base in feet
      - `top` integer: Cloud top in feet
    - `icgTurb` object[], required: Icing and turbulence forecasts
      - `var` 'ICE' | 'TURB', required: Variable - ice or turb
      - `intensity` integer, required: Intensity setting (0-9, see TAF implementation table)
      - `minAlt` integer, required: Minimum altitude in feet
      - `maxAlt` integer, required: Maximum altitude in feet
    - `temp` object[], required: The temp Schema
      - `validTime` integer, required: Valid time for max/min temperature (unix timestamp)
      - `sfcTemp` integer, required: Surface tmperature in Celsius
      - `maxOrMin` 'MAX' | 'MIN', required: Is the value a max or min

## Other responses

- `400`: Input validation errors

---

[API](https://skmtc.dev/aviationweather/apis/aviationweather-gov-api.md) - [All operations](https://skmtc.dev/aviationweather/apis/aviationweather-gov-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aviationweather/apis/aviationweather-gov-api/revisions/282226ebbe51?raw)