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-09-24T20:45:00Z",
"expires": "2026-09-25T03:00:00Z"
},
"product": "ZULU",
"altitude": {
"minimum": {
"code": "FZL",
"text": "FZL"
},
"maximum": {
"feet": 22000
}
},
"fzl_altitude": {
"minimum": {
"feet": 6000
},
"maximum": {
"feet": 12000
}
},
"hazard": {
"type": {
"code": "ICE",
"text": "Icing"
},
"severity": {
"code": "MOD",
"text": "Moderate"
}
},
"reason": {
"code": "ICE",
"text": "Icing"
}
}
]
}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-09-24T20:45:00Z",
"expires": "2026-09-25T03:00:00Z"
},
"product": "ZULU",
"altitude": {
"minimum": {
"code": "FZL",
"text": "FZL"
},
"maximum": {
"feet": 22000
}
},
"fzl_altitude": {
"minimum": {
"feet": 6000
},
"maximum": {
"feet": 12000
}
},
"hazard": {
"type": {
"code": "ICE",
"text": "Icing"
},
"severity": {
"code": "MOD",
"text": "Moderate"
}
},
"reason": {
"code": "ICE",
"text": "Icing"
},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-123.0517,
49.0232
],
[
-118.4544,
48.9997
],
[
-118.5809,
47.5592
],
[
-119.586,
45.8136
],
[
-121.6889,
44.0038
],
[
-122.4226,
41.8863
],
[
-123.3818,
40.3224
],
[
-124.1032,
40.0785
],
[
-124.9523,
41.3786
],
[
-124.6997,
42.7898
],
[
-124.0789,
44.0658
],
[
-124.2785,
45.57
],
[
-125.6004,
46.3635
],
[
-127.1686,
46.4333
],
[
-128.0131,
48.1103
],
[
-125.695,
48.4094
],
[
-123.0517,
49.0232
]
]
]
}
}
]
}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
-