CheckWX Aviation Weather API

CheckWX API

  • Overview Version 2 METAR TAF G-AIRMET STATION ChatBots
  • Code Examples
  • ICAO Search
  • Pricing
Login Sign up
Menu

Documentation

  • Overview
  • Version 2
  • METAR
  • TAF
  • G-AIRMET
  • STATION
  • ChatBots

Pages

  • Code Examples
  • ICAO Search
  • Pricing
Login Sign up

G-AIRMET

Overview

  • Introduction
  • Response Formats

Endpoints

  • Covering ICAO
  • Covering Lat/Long

Fields

  • G-AIRMET Fields

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/short

Response:

{
  "results": 1,
  "data": [
    {
      "period": {
        "issued": "2026-06-25T20:45:00Z",
        "expires": "2026-06-26T03:00:00Z"
      },
      "product": "ZULU",
      "altitude": {
        "minimum": {},
        "maximum": {
          "feet": -1
        }
      },
      "fzl_altitude": {
        "minimum": {
          "feet": -1
        },
        "maximum": {
          "feet": -1
        }
      },
      "hazard": {
        "type": {
          "code": "FZLVL",
          "text": "Freezing level"
        }
      }
    }
  ]
}

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/decoded

Response:

{
  "results": 1,
  "data": [
    {
      "period": {
        "issued": "2026-06-25T20:45:00Z",
        "expires": "2026-06-26T03:00:00Z"
      },
      "product": "ZULU",
      "altitude": {
        "minimum": {},
        "maximum": {
          "feet": -1
        }
      },
      "fzl_altitude": {
        "minimum": {
          "feet": -1
        },
        "maximum": {
          "feet": -1
        }
      },
      "hazard": {
        "type": {
          "code": "FZLVL",
          "text": "Freezing level"
        }
      },
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            -92.4258,
            58.3527
          ],
          [
            -92.1681,
            58.0272
          ],
          [
            -91.0543,
            57.838
          ],
          [
            -89.3815,
            57.5881
          ],
          [
            -88.1602,
            57.0703
          ],
          [
            -86.8951,
            56.422
          ],
          [
            -85.6456,
            55.998
          ],
          [
            -84.0426,
            55.6433
          ],
          [
            -82.464,
            55.2184
          ],
          [
            -81.637,
            54.3195
          ],
          [
            -81.1312,
            53.4893
          ],
          [
            -80.6622,
            54.5764
          ],
          [
            -79.7276,
            55.2206
          ],
          [
            -78.5302,
            55.6925
          ],
          [
            -77.8587,
            55.9559
          ],
          [
            -77.2563,
            56.5272
          ],
          [
            -78.0102,
            57.498
          ],
          [
            -78.3422,
            57.8233
          ]
        ]
      }
    }
  ]
}

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

Example: KPIE

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

Example: 40.72

The latitude in decimal degrees

minimum value: -90

maximum value: 90

longitude

float

Required

Example: -73.99

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

Prev Page

TAF

Next Page

STATION

© 2026 BluePony Technologies, Inc.

Privacy Terms News Contact