METAR Endpoints

Two endpoints are available for METAR data.

GET/metar/{icao}

Fetches the latest METAR report for the given ICAO airport code from live weather data.

Parameters

Field	Type	Req	Description
icao	string	✓	The 4-letter ICAO code of the airport (e.g. LFPO, EGLL, KJFK).

Example Request

curl -X GET "https://api.metar-taf-decoder.com/metar/LFPO" \
  -H "Accept-Language: en" \
  -H "X-API-Key: your-api-key"

Example Response

{
  "message": "LFPO 010830Z 28010KT 9999 FEW020 15/08 Q1015",
  "airport": {
    "icao": "LFPO",
    "name": "Paris-Orly"
  },
  "day": 1,
  "time": "0830",
  "wind": {
    "speed": 10,
    "unit": "KT",
    "direction": "W",
    "directionDegrees": 280
  },
  "visibility": {
    "mainVisibility": "9999"
  },
  "verticalVisibility": null,
  "clouds": [
    {
      "quantity": "FEW",
      "height": 2000,
      "unit": "FT"
    }
  ],
  "weatherConditions": [],
  "temperature": 15,
  "dewPoint": 8,
  "altimeter": 1015,
  "remark": null,
  "windShear": null,
  "runways": [],
  "trends": [],
  "cavok": false,
  "nosig": false,
  "auto": false,
  "amendment": false,
  "cancelled": false,
  "nil": false,
  "corrected": false
}

POST/metar

Decodes a raw METAR string that you provide in the request body.

Request Body

Field	Type	Req	Description
body	string	✓	The raw METAR string as plain text (e.g. LFPO 010830Z 28010KT 9999 FEW020 15/08 Q1015).

Content-Type: text/plain

Example Request

curl -X POST "https://api.metar-taf-decoder.com/metar" \
  -H "Content-Type: text/plain" \
  -H "Accept-Language: en" \
  -H "X-API-Key: your-api-key" \
  -d "LFPO 010830Z 28010KT 9999 FEW020 15/08 Q1015"

Example Response

{
  "message": "LFPO 010830Z 28010KT 9999 FEW020 15/08 Q1015",
  "airport": {
    "icao": "LFPO",
    "name": "Paris-Orly"
  },
  "day": 1,
  "time": "0830",
  "wind": {
    "speed": 10,
    "unit": "KT",
    "direction": "W",
    "directionDegrees": 280
  },
  "visibility": {
    "mainVisibility": "9999"
  },
  "verticalVisibility": null,
  "clouds": [
    {
      "quantity": "FEW",
      "height": 2000,
      "unit": "FT"
    }
  ],
  "weatherConditions": [],
  "temperature": 15,
  "dewPoint": 8,
  "altimeter": 1015,
  "remark": null,
  "windShear": null,
  "runways": [],
  "trends": [],
  "cavok": false,
  "nosig": false,
  "auto": false,
  "amendment": false,
  "cancelled": false,
  "nil": false,
  "corrected": false
}

Response Fields

Field	Type	Req	Description
message	string	✓	The original raw METAR string.
airport	Airport	✓	Airport information (ICAO code and name).
day	number	✓	Day of the month the report was issued.
time	string	✓	Time the report was issued (HHmm format).
wind	Wind \| null	–	Wind information (speed, direction, gusts, unit).
visibility	Visibility \| null	–	Visibility information (main visibility, minimum, direction, unit).
verticalVisibility	number \| null	–	Vertical visibility in feet or meters.
verticalVisibilityUnit	string \| null	–	Unit of vertical visibility: FT or M.
clouds	Cloud[]	–	Array of cloud layers (quantity, type, height, unit).
weatherConditions	WeatherCondition[]	–	Array of current weather phenomena (intensity, descriptive, phenomenons).
temperature	number	✓	Air temperature in Celsius.
dewPoint	number	✓	Dew point temperature in Celsius.
altimeter	number	✓	Altimeter setting (hPa or inHg depending on prefix).
remark	string \| null	–	Free-text remark section of the METAR.
windShear	WindShear \| null	–	Wind shear information if present.
runways	Runway[]	–	Array of runway visual range (RVR) information.
trends	MetarTrend[]	–	Array of weather trend groups (BECMG, TEMPO, NOSIG).
cavok	boolean	–	True if conditions are CAVOK (Ceiling And Visibility OK).
nosig	boolean	–	True if NOSIG (no significant change expected).
auto	boolean	–	True if the report was generated automatically.
amendment	boolean	–	True if this is an amended METAR.
cancelled	boolean	–	True if the METAR was cancelled.
nil	boolean	–	True if the METAR is NIL (no observation).
corrected	boolean	–	True if this is a corrected METAR.

Object Types

`Airport object`

Field	Type	Req	Description
icao	string	✓	The 4-letter ICAO code of the airport.
name	string	✓	The full name of the airport.

`Wind object`

Field	Type	Req	Description
speed	number	✓	Wind speed value.
unit	string	✓	Speed unit. KT (knots) or MPS (meters per second).
direction	string	✓	Cardinal or compass direction (e.g. N, NE, W, VRB).
directionDegrees	number	✓	Direction in degrees (0–360). 0 when variable.
gust	number \| null	–	Gust speed, if present.
minVariation	number \| null	–	Minimum wind direction variation in degrees (variable winds).
maxVariation	number \| null	–	Maximum wind direction variation in degrees (variable winds).

`WindShear object (extends Wind)`

Field	Type	Req	Description
(all Wind fields)	—	✓	Inherits all fields from the Wind object.
height	number	✓	Height at which wind shear occurs.
heightUnit	string \| null	–	Unit of height: FT (feet) or M (meters).

`Visibility object`

Field	Type	Req	Description
mainVisibility	string	✓	Main visibility value as a string (e.g. 9999, 6000, 1SM).
minVisibility	number \| null	–	Minimum directional visibility value, if present.
minDirection	string \| null	–	Cardinal direction of the minimum visibility, if present.
unit	string \| null	–	Visibility unit when not in meters (e.g. SM for statute miles).

`Cloud object`

Field	Type	Req	Description
quantity	string	✓	Sky coverage code: FEW, SCT, BKN, OVC, NSC, NCD, SKC, CAVOK.
type	string \| null	–	Cloud type when specified (e.g. CB for cumulonimbus, TCU for towering cumulus).
height	number \| null	–	Cloud base height in the specified unit.
unit	string \| null	–	Height unit: FT (feet) or M (meters).

`WeatherCondition object`

Field	Type	Req	Description
intensity	string \| null	–	Intensity qualifier: + (heavy), - (light), or absent for moderate.
descriptive	string \| null	–	Descriptive code (e.g. SH for showers, TS for thunderstorm, FZ for freezing).
phenomenons	string[]	–	Array of phenomenon codes (e.g. RA for rain, SN for snow, FG for fog).

`Runway object`

Field	Type	Req	Description
name	string	✓	Runway designator (e.g. 28L, 10R).
minRange	number \| null	–	Minimum runway visual range in meters, if a range is given.
maxRange	number \| null	–	Maximum runway visual range in meters, if a range is given.
indicator	string \| null	–	Trend indicator: U (upward), D (downward), N (no change).
trend	string \| null	–	Tendency of RVR: U, D, or N.
depositType	string \| null	–	Type of deposit on the runway (e.g. ice, snow, water).
coverage	string \| null	–	Fraction of runway covered by deposit.
thickness	string \| null	–	Thickness of deposit in millimetres.
brakingCapacity	string \| null	–	Braking action or friction coefficient.

`TrendTime object`

Field	Type	Req	Description
type	string	✓	Time group type: AT, FM, or TL.
time	string	✓	The time value in HHmm format.

`MetarTrend object`

Field	Type	Req	Description
type	string	✓	Trend type: BECMG or TEMPO.
times	TrendTime[]	–	Array of TrendTime objects (AT, FM, TL time groups).
wind	Wind \| null	–	Forecast wind during the trend period.
windShear	WindShear \| null	–	Wind shear information during the trend period.
clouds	Cloud[]	–	Forecast cloud layers during the trend period.
visibility	Visibility \| null	–	Forecast visibility during the trend period.
weatherConditions	WeatherCondition[]	–	Forecast weather phenomena during the trend period.
cavok	boolean	–	True if conditions are CAVOK during the trend period.