Aviation Weather Center

Aviation Weather Center Navigational Data API

Decoded navigational information

GitHub OpenAPI

Documentation

📖
Documentation
https://aviationweather.gov/data/api/
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/rate-limits/aviationweather-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/openapi/aviationweather-navigational-data-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-schema/aviationweather-metar-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-schema/aviationweather-taf-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-schema/aviationweather-pirep-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-schema/aviationweather-airsigmet-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-schema/aviationweather-isigmet-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-schema/aviationweather-gairmet-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-schema/aviationweather-airmet-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-schema/aviationweather-cwa-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-schema/aviationweather-station-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-schema/aviationweather-airport-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-structure/aviationweather-metar-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-structure/aviationweather-taf-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/json-structure/aviationweather-airport-structure.json

Other Resources

🔗
OpenAPISource
https://aviationweather.gov/data/schema/openapi.yaml
🔗
Examples
https://aviationweather.gov/data/example/
🔗
TermsOfService
https://aviationweather.gov/data/api/
🔗
GovernmentAPI
https://aviationweather.gov/data/api/
🔗
DataAPI
https://aviationweather.gov/api/data
🔗
OpenDataAPI
https://aviationweather.gov/api/data
🔗
Status
https://aviationweather.gov/
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-metar-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-taf-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-pirep-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-airsigmet-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-isigmet-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-gairmet-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-airmet-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-tcf-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-cwa-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-windtemp-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-areafcst-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-fcstdisc-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-mis-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-stationinfo-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-airport-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-navaid-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-fix-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-feature-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-obstacle-example.json
🔗
ExamplePayload
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/examples/aviationweather-dataserver-example.json
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/apis.yml

OpenAPI Specification

aviationweather-navigational-data-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: AviationWeather.gov Navigational Data API
  description: 'Schema for the public data API of AviationWeather.gov, operated by the NOAA/NWS

    Aviation Weather Center (AWC). Provides machine-to-machine access to operational

    aviation weather products including METARs, TAFs, PIREPs, SIGMETs, AIRMETs,

    G-AIRMETs, CWAs, TFM convective forecasts, area forecasts, forecast discussions,

    meteorological information statements, and reference data for stations, airports,

    NAVAIDs, fixes, features, and obstacles.


    Rate limit: 100 requests per minute per user. Most endpoints return a maximum of

    400 entries. Historical depth is up to 15 days. No API key required.'
  termsOfService: https://aviationweather.gov/data/api/
  contact:
    name: NOAA / NWS Aviation Weather Center
    url: https://www.weather.gov/aviation/awc
  license:
    name: U.S. Government Work (public domain)
    url: https://www.weather.gov/disclaimer
  version: v4.0
servers:
- url: https://aviationweather.gov
  description: NOAA Aviation Weather Center production endpoint
tags:
- name: Navigational Data
  description: Decoded navigational information
paths:
  /api/data/stationinfo:
    get:
      tags:
      - Navigational Data
      summary: Get Station Info
      description: Station observation location information
      parameters:
      - $ref: '#/components/parameters/ids'
      - $ref: '#/components/parameters/bbox'
      - $ref: '#/components/parameters/RawJSONGeoXML'
      responses:
        200:
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StationInfoJSON'
            application/geo+json:
              schema:
                $ref: '#/components/schemas/StationInfoGeoJSON'
            application/xml:
              schema:
                $ref: '#/components/schemas/StationInfoXML'
        400:
          $ref: '#/components/responses/400'
  /api/data/airport:
    get:
      tags:
      - Navigational Data
      summary: Get Airport Info
      description: Information about airports
      parameters:
      - $ref: '#/components/parameters/ids'
      - $ref: '#/components/parameters/bbox'
      - name: format
        in: query
        description: Format
        required: false
        explode: true
        schema:
          type: string
          enum:
          - decoded
          - json
          - geojson
          default: decoded
      responses:
        200:
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    icaoId:
                      type: string
                      examples:
                      - KMCI
                    iataId:
                      type: string
                      examples:
                      - MCI
                    faaId:
                      type: string
                      examples:
                      - MCI
                    name:
                      type: string
                      examples:
                      - KANSAS CITY/KANSAS CITY INTL
                    state:
                      type: string
                      examples:
                      - MO
                    country:
                      type: string
                      examples:
                      - US
                    source:
                      type: string
                      examples:
                      - FAA
                    type:
                      type: string
                      examples:
                      - ARP
                    lat:
                      type: string
                      examples:
                      - 39.2976
                    lon:
                      type: string
                      examples:
                      - -94.7139
                    elev:
                      type: string
                      examples:
                      - 313
                    magdec:
                      type: string
                      examples:
                      - 02E
                    owner:
                      type: string
                      examples:
                      - P
                    runways:
                      type: array
        400:
          $ref: '#/components/responses/400'
  /api/data/navaid:
    get:
      tags:
      - Navigational Data
      summary: Get Navigational Aid Info
      description: Navigational aid data
      parameters:
      - name: ids
        in: query
        description: three character identifier
        required: false
        examples:
          '-':
            value: ''
          barbq:
            summary: MCI
            value: MCI
        schema:
          type: string
      - $ref: '#/components/parameters/bbox'
      - $ref: '#/components/parameters/RawJSONGeo'
      responses:
        200:
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      examples:
                      - MCI
                    type:
                      type: string
                      examples:
                      - VORTAC
                    name:
                      type: string
                      examples:
                      - Kansas City
                    state:
                      type: string
                      examples:
                      - MO
                    country:
                      type: string
                      examples:
                      - US
                    lat:
                      type: number
                      examples:
                      - 39.2853
                    lon:
                      type: number
                      examples:
                      - -94.7371
                    elev:
                      type: number
                      examples:
                      - 310
                    freq:
                      type: number
                      examples:
                      - 113.25
                    mag_dec:
                      type: string
                      examples:
                      - 05E
        400:
          $ref: '#/components/responses/400'
  /api/data/fix:
    get:
      tags:
      - Navigational Data
      summary: Get Navigational Fix and Waypoint Info
      description: Navigational fix data
      parameters:
      - name: ids
        in: query
        description: 5 letter Fix ID(s)
        required: false
        examples:
          '-':
            value: ''
          barbq:
            summary: BARBQ
            value: BARBQ
        schema:
          type: string
      - $ref: '#/components/parameters/bbox'
      - $ref: '#/components/parameters/RawJSONGeo'
      responses:
        200:
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      examples:
                      - BARBQ
                    type:
                      type: string
                      examples:
                      - I
                    lat:
                      type: number
                      examples:
                      - 39.0811
                    lon:
                      type: number
                      examples:
                      - -94.7681
        400:
          $ref: '#/components/responses/400'
  /api/data/feature:
    get:
      tags:
      - Navigational Data
      summary: Get Feature Info
      description: Additional geographic features
      parameters:
      - $ref: '#/components/parameters/bbox'
      - $ref: '#/components/parameters/RawJSONGeo'
      responses:
        200:
          description: successful operation
        400:
          $ref: '#/components/responses/400'
  /api/data/obstacle:
    get:
      tags:
      - Navigational Data
      summary: Get Obstacle Info
      description: Aviation obstacle information
      parameters:
      - $ref: '#/components/parameters/bbox'
      - $ref: '#/components/parameters/RawJSONGeo'
      responses:
        200:
          description: successful operation
        400:
          $ref: '#/components/responses/400'
components:
  parameters:
    RawJSONGeo:
      name: format
      in: query
      description: Format
      required: false
      explode: true
      schema:
        type: string
        enum:
        - raw
        - json
        - geojson
        default: raw
    ids:
      name: ids
      in: query
      description: Station ID(s)
      required: false
      examples:
        '-':
          value: ''
        id:
          summary: A single ICAO Id
          value: KMCI
        ids:
          summary: A list of ICAO Ids separated by commas
          value: KMCI,KORD,KBOS
        states:
          summary: A 2 letter state abbreviation preceded by a @
          value: '@WA'
      schema:
        type: string
    RawJSONGeoXML:
      name: format
      in: query
      description: Format
      required: false
      explode: true
      schema:
        type: string
        enum:
        - raw
        - json
        - geojson
        - xml
        default: raw
    bbox:
      name: bbox
      in: query
      description: Geographic bounding box (lat0, lon0, lat1, lon1)
      required: false
      examples:
        '-':
          value: ''
        box:
          summary: A small box around Chicago
          value: 40,-90,45,-85
      schema:
        type: string
  schemas:
    StationInfoJSON:
      type: array
      items:
        type: object
        properties:
          icaoId:
            type: string
            description: ICAO station identifier
          iataId:
            type: string
            description: IATA station identifier
          faaId:
            type: string
            description: FAA station identifier
          site:
            type: string
            description: Site name
          lat:
            type: number
            description: Latitude
          lon:
            type: number
            description: Longitude
          elev:
            type: number
            description: Elevation
          state:
            type: string
            description: State or region
          country:
            type: string
            description: Country
          priority:
            type: number
            description: Priority display order
          siteType:
            type: array
            description: METAR and/or TAF availability
            items:
              type: string
    StationInfoXML:
      xml:
        name: response
      type: object
      properties:
        request_index:
          type: number
        data_source:
          properties:
            name:
              type: string
              enum:
              - aircraftreports
              xml:
                attribute: true
        request:
          properties:
            type:
              type: string
              enum:
              - retrieve
              xml:
                attribute: true
        errors: null
        warnings: null
        time_taken_ms:
          type: number
        data:
          type: array
          xml:
            name: data
            wrapped: true
          items:
            type: object
            xml:
              name: Station
            properties:
              station_id:
                type: string
              iata_id:
                type: string
              wmo_id:
                type: string
              faa_id:
                type: string
              latitude:
                type: string
              longitude:
                type: string
              elevation_m:
                type: string
              site:
                type: string
              state:
                type: string
              country:
                type: string
              site_type:
                type: object
                properties:
                  METAR: null
                  TAF: null
    StationInfoGeoJSON:
      type: object
      properties:
        type:
          type: string
          enum:
          - FeatureCollection
        features:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                - Feature
              id:
                type: number
              properties:
                type: object
                properties:
                  icaoId:
                    type: string
                    description: ICAO station identifier
                  iataId:
                    type: string
                    description: IATA station identifier
                  faaId:
                    type: string
                    description: FAA station identifier
                  site:
                    type: string
                    description: Site name
                  elev:
                    type: number
                    description: Elevation
                  state:
                    type: string
                    description: State or region
                  country:
                    type: string
                    description: Country
                  priority:
                    type: number
                    description: Priority display order
                  siteType:
                    type: array
                    description: METAR and/or TAF availability
                    items:
                      type: string
              geometry:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                    - Point
                  coordinates:
                    type: array
                    minItems: 2
                    maxItems: 2
                    items:
                      type: number
                    examples:
                    - - -87.9316
                      - 41.9602