G-AIRMET
G-AIRMET is weather advisory issued by the U.S. National Weather Service. It warns pilots of widespread weather conditions that may affect flights, especially for general aviation and smaller aircraft.
G-AIRMETs are issued for three primary hazard categories:
Turbulence:
Moderate turbulence, Strong surface winds, Low-level wind shear
Icing:
Moderate icing, Freezing level
Ceilings and Visibility:
Widespread low ceilings, Reduced visibility (e.g., fog, precipitation)
API Usage
Our API provides two G-AIRMET endpoints that allow you to determine whether a given ICAO airport identifier or latitude/longitude coordinate falls within one or more active G-AIRMET polygons.
Raw, Short, or Decoded Responses
We offer two API response models for G-AIRMETs - Short and Decoded - allowing you to choose between a summary JSON data or full JSON data including GeoJSON polygon coordinate points for application use.
1. Short Response
Add /short to the end of the endpoint path to receive a simplified JSON response.
Example:
https://api.checkwx.com/v2/gairmet/ktpa/shortResponse:
{
"results": 1,
"data": [
{
"period": {
"issued": "2026-08-11T20:45:00Z",
"expires": "2026-08-12T03:00:00Z"
},
"product": "TANGO",
"altitude": {
"minimum": {},
"maximum": {
"feet": -1
}
},
"fzl_altitude": {
"minimum": {
"feet": -1
},
"maximum": {
"feet": -1
}
},
"hazard": {
"type": {
"code": "LLWS",
"text": "Low level wind shear"
}
},
"reason": {
"code": "AIR SPEED LOSS OR GAIN OF 20KTS OR MORE BELOW 2000 FT AGL",
"text": "AIR SPEED LOSS OR GAIN of 20KTS OR MORE BELOW 2000 FT AGL"
}
}
]
}2. Decoded Response
Add /decoded to the endpoint path to receive a full structured JSON format including GeoJSON polygon points.
Example:
https://api.checkwx.com/v2/gairmet/ktpa/decodedResponse:
{
"results": 1,
"data": [
{
"period": {
"issued": "2026-08-11T20:45:00Z",
"expires": "2026-08-12T03:00:00Z"
},
"product": "TANGO",
"altitude": {
"minimum": {},
"maximum": {
"feet": -1
}
},
"fzl_altitude": {
"minimum": {
"feet": -1
},
"maximum": {
"feet": -1
}
},
"hazard": {
"type": {
"code": "LLWS",
"text": "Low level wind shear"
}
},
"reason": {
"code": "AIR SPEED LOSS OR GAIN OF 20KTS OR MORE BELOW 2000 FT AGL",
"text": "AIR SPEED LOSS OR GAIN of 20KTS OR MORE BELOW 2000 FT AGL"
},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-79.4297,
38.3424
],
[
-78.96,
38.224
],
[
-79.1058,
37.3881
],
[
-79.632,
36.7483
],
[
-80.4108,
36.2036
],
[
-81.2607,
35.8251
],
[
-81.9017,
36.0288
],
[
-81.7944,
36.4601
],
[
-81.3021,
37.1139
],
[
-80.4544,
37.8433
],
[
-79.4297,
38.3424
]
]
]
}
}
]
}G-AIRMET Covering ICAO
Returns all G-AIRMET polygons that are currently covering the specified ICAO
Endpoint Path
/v2/gairmet/{icao}
Path Parameters
icao
string
Required
A single ICAO code (multiple ICAO codes are not allowed)
TAF Nearest to Latitude/Longitude
Returns all G-AIRMET polygons that are currently covering the specified Latitude/Longitude
Endpoint Path
/v2/gairmet/lat/{latitude}/lon/{longitude}
Path Parameters
latitude
float
Required
The latitude in decimal degrees
minimum value: -90
maximum value: 90
longitude
float
Required
The longitude in decimal degrees
minimum value: -180
maximum value: 180
G-AIRMET Fields
The following table lists the fields which are returned by G-AIRMET endpoints
-
icao
string
Examples:
ICAO airport code or station indicator
KPIE -
name
string
Station name
John F Kennedy International Airport -
location
string
City, (State/Province), Country
New York, New York, United States -
period
object
-
issued
string
DateTime the G-AIRMET was issued
2025-12-24 16:00:00 -
expires
string
DateTime the G-AIRMET expires
2025-12-25 16:00:00
-