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-11-09T20:45:00Z",
        "expires": "2026-11-10T03: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-11-09T20:45:00Z",
        "expires": "2026-11-10T03: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": [
          [
            -137.3682,
            49.567
          ],
          [
            -136.2366,
            50.1671
          ],
          [
            -135.4875,
            50.9989
          ],
          [
            -133.9788,
            51.4453
          ],
          [
            -132.2848,
            51.2531
          ],
          [
            -131.6118,
            51.1421
          ],
          [
            -130.6878,
            51.3256
          ],
          [
            -129.9147,
            52.0359
          ],
          [
            -129.7082,
            53.0158
          ],
          [
            -129.423,
            53.5879
          ],
          [
            -128.6375,
            53.8349
          ],
          [
            -128.8938,
            54.4458
          ],
          [
            -129.8225,
            54.3149
          ],
          [
            -130.1131,
            53.9354
          ],
          [
            -130.7143,
            54.492
          ],
          [
            -130.263,
            55.2853
          ],
          [
            -129.2526,
            55.9959
          ]
        ]
      }
    }
  ]
}

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