Aviation Weather Center Weather Data API

openapi: 3.2.0
info:
  title: AviationWeather.gov Navigational Data Weather 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: Weather Data
  description: Decoded weather information
paths:
  /api/data/metar:
    get:
      tags:
      - Weather Data
      summary: Get METAR Observations
      description: Decoded aviation weather observations. Station identifiers or a bounding box is required.
      parameters:
      - $ref: '#/components/parameters/ids'
      - $ref: '#/components/parameters/bbox'
      - name: format
        in: query
        description: Format
        required: false
        explode: true
        schema:
          type: string
          enum:
          - raw
          - decoded
          - json
          - geojson
          - xml
          - iwxxm
          default: raw
      - name: taf
        in: query
        description: Include TAF
        required: false
        schema:
          type: boolean
          default: false
      - $ref: '#/components/parameters/hours'
      - $ref: '#/components/parameters/date'
      responses:
        200:
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/METARJSON'
            application/geo+json:
              schema:
                $ref: '#/components/schemas/METARGeoJSON'
            application/xml:
              schema:
                $ref: '#/components/schemas/METARXML'
            text/plain:
              schema:
                $ref: '#/components/schemas/METARtext'
        400:
          $ref: '#/components/responses/400'
  /api/data/taf:
    get:
      tags:
      - Weather Data
      summary: Get TAFs
      description: Decoded Terminal Aerodrome Forecast products. Station identifiers or a bounding box is required.
      parameters:
      - $ref: '#/components/parameters/ids'
      - $ref: '#/components/parameters/bbox'
      - $ref: '#/components/parameters/RawJSONGeoXMLIWXXM'
      - name: metar
        in: query
        description: Include METAR
        required: false
        schema:
          type: boolean
      - name: time
        in: query
        description: Process time by valid (default) or issuance time
        required: false
        schema:
          type: string
          enum:
          - valid
          - issue
      - $ref: '#/components/parameters/date'
      responses:
        200:
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TAFJSON'
            application/geo+json:
              schema:
                $ref: '#/components/schemas/TAFGeoJSON'
            text/plain:
              schema:
                $ref: '#/components/schemas/TAFtext'
        400:
          $ref: '#/components/responses/400'
  /api/data/pirep:
    get:
      tags:
      - Weather Data
      summary: Get Pilot Reports
      description: Pilot reports issued in PIREP or AIREP format. Bounding box, or center point identifier and radial distance, required.
      parameters:
      - name: id
        in: query
        description: Airport ID for center of search
        required: false
        explode: true
        schema:
          type: string
      - name: distance
        in: query
        description: Radial distance to search
        required: false
        explode: true
        schema:
          type: number
      - $ref: '#/components/parameters/bbox'
      - name: format
        in: query
        description: Format
        required: false
        explode: true
        schema:
          type: string
          enum:
          - raw
          - decoded
          - json
          - geojson
          - xml
          default: raw
      - name: age
        in: query
        description: Hours Back
        required: false
        explode: true
        schema:
          type: number
      - name: level
        in: query
        description: Level +-3000' to search
        required: false
        explode: true
        schema:
          type: number
      - name: inten
        in: query
        description: Minimum intensity
        required: false
        explode: true
        schema:
          type: string
          enum:
          - lgt
          - mod
          - sev
      - $ref: '#/components/parameters/date'
      responses:
        200:
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PIREPJSON'
            application/geo+json:
              schema:
                $ref: '#/components/schemas/PIREPGeoJSON'
            application/xml:
              schema:
                $ref: '#/components/schemas/PIREPXML'
            text/plain:
              schema:
                $ref: '#/components/schemas/PIREPtext'
        400:
          $ref: '#/components/responses/400'
  /api/data/airsigmet:
    get:
      tags:
      - Weather Data
      summary: Get Domestic SIGMETs
      description: Domestic SIGMETs for the contiguous United States. Does not include SIGMETs issued by the US in international format.
      parameters:
      - $ref: '#/components/parameters/RawJSONGeoXMLIWXXM'
      - name: types
        in: query
        description: Product type
        required: false
        deprecated: true
        schema:
          type: string
          enum:
          - sigmet
          - airmet
      - name: hazard
        in: query
        description: Hazard
        required: false
        schema:
          type: string
          enum:
          - conv
          - turb
          - ice
          - ifr
      - name: level
        in: query
        description: The level +-3000' to search
        required: false
        explode: true
        schema:
          type: number
      responses:
        200:
          description: successful operation
          content:
            text/plain:
              schema:
                type: string
            application/xml:
              schema:
                type: object
            application/json:
              schema:
                $ref: '#/components/schemas/AirSigmetJSON'
            application/geo+json:
              schema:
                $ref: '#/components/schemas/AirSigmetGeoJSON'
        400:
          $ref: '#/components/responses/400'
  /api/data/isigmet:
    get:
      tags:
      - Weather Data
      summary: Get International SIGMETs
      description: Decoded international SIGMETs. This does not include SIGMETs issued by the United States in domestic format (i.e. convective and non-convective domestic SIGMETS).
      parameters:
      - $ref: '#/components/parameters/RawJSONGeoXMLIWXXM'
      - name: hazard
        in: query
        description: Hazard
        required: false
        explode: true
        schema:
          type: string
          enum:
          - turb
          - ice
      - name: level
        in: query
        description: Level +-3000' to search
        required: false
        explode: true
        schema:
          type: number
      - $ref: '#/components/parameters/date'
      responses:
        200:
          description: Successful operation
          content:
            text/plain:
              schema:
                type: string
            application/xml:
              schema:
                type: object
            application/json:
              schema:
                $ref: '#/components/schemas/ISigmetJSON'
            application/geo+json:
              schema:
                $ref: '#/components/schemas/ISigmetGeoJSON'
        400:
          $ref: '#/components/responses/400'
  /api/data/gairmet:
    get:
      tags:
      - Weather Data
      summary: Get US Graphical AIRMETs
      description: Decoded G-AIRMETs for the contiguous United States. See /api/data/airmet for similar advisories over Alaska.
      parameters:
      - name: product
        in: query
        description: Product type
        required: false
        explode: true
        schema:
          type: string
          enum:
          - sierra
          - tango
          - zulu
      - $ref: '#/components/parameters/RawJSONGeoXML'
      - name: hazard
        in: query
        description: Hazard
        required: false
        explode: true
        schema:
          type: string
          enum:
          - turb-hi
          - turb-lo
          - llws
          - sfc_wind
          - ifr
          - mtn_obs
          - ice
          - fzlvl
      - $ref: '#/components/parameters/date'
      - name: fore
        in: query
        description: Forecast hour from selected forecast package
        required: false
        schema:
          type: number
          enum:
          - 0
          - 3
          - 6
          - 9
          - 12
      responses:
        200:
          description: successful operation
          content:
            text/plain:
              schema:
                type: string
            application/json:
              schema:
                $ref: '#/components/schemas/GairmetJSON'
            application/geo+json:
              schema:
                $ref: '#/components/schemas/GairmetGeoJSON'
            application/xml:
              schema:
                type: object
        400:
          $ref: '#/components/responses/400'
  /api/data/airmet:
    get:
      tags:
      - Weather Data
      summary: Get AIRMETs
      description: Decoded domestic AIRMETs (Alaska only). See /api/data/gairmet for similar advisories over the contiguous United States.
      parameters:
      - $ref: '#/components/parameters/JSONGeoIWXXM'
      - name: hazard
        in: query
        description: Hazard
        required: false
        explode: true
        schema:
          type: string
          enum:
          - turb
          - ifr
          - conv
          - ice
      - name: level
        in: query
        description: Level +-3000' to search
        required: false
        explode: true
        schema:
          type: number
      - $ref: '#/components/parameters/date'
      responses:
        200:
          description: successful operation
          content:
            application/xml:
              schema:
                type: object
            application/json:
              schema:
                type: object
        400:
          $ref: '#/components/responses/400'
  /api/data/tcf:
    get:
      tags:
      - Weather Data
      summary: Get TFM Convective Forecast
      description: Traffic Flow Management (TFM) Convective Forecast. See https://aviationweather.gov/tcf/ for more information.
      parameters:
      - $ref: '#/components/parameters/RawGeo'
      responses:
        200:
          description: successful operation
          content:
            text/plain:
              schema:
                type: string
            application/json:
              schema:
                $ref: '#/components/schemas/TcfGeoJSON'
        400:
          $ref: '#/components/responses/400'
  /api/data/cwa:
    get:
      tags:
      - Weather Data
      summary: Get CWSU Center Advisories
      description: Center Weather Advisories issued by NWS Center Weather Service Units (CWSUs)
      parameters:
      - name: hazard
        in: query
        description: Hazard
        required: false
        explode: true
        schema:
          type: string
          enum:
          - ts
          - turb
          - ice
          - ifr
          - pcpn
          - unk
      - $ref: '#/components/parameters/RawJSONGeo'
      - $ref: '#/components/parameters/date'
      responses:
        200:
          description: successful operation
          content:
            text/plain:
              schema:
                type: string
            application/json:
              schema:
                $ref: '#/components/schemas/CwaJSON'
            application/geo+json:
              schema:
                $ref: '#/components/schemas/CwaGeoJSON'
        400:
          $ref: '#/components/responses/400'
  /api/data/windtemp:
    get:
      tags:
      - Weather Data
      summary: Get Wind and Temperature Point Data
      description: Wind and temperature information from the legacy FD winds
      parameters:
      - name: region
        in: query
        required: false
        schema:
          type: string
          enum:
          - us
          - bos
          - mia
          - chi
          - dfw
          - slc
          - sfo
          - alaska
          - hawaii
          - other_pac
        description: "Region:\n * `us` - All contiguous US sites\n * `bos` - Northeast\n * `mia` - Southeast\n * `chi` - North central\n * `dfw` - South central\n * `slc` - Rocky Mountain\n * `sfo` - Pacific Coast\n * `alaska` - Alaska\n * `hawaii` - Hawaii\n * `other_pac` - Western Pacific\n"
      - name: level
        in: query
        description: Level
        required: false
        schema:
          type: string
          enum:
          - low
          - high
      - name: fcst
        in: query
        description: Forecast cycle
        required: false
        schema:
          type: string
          enum:
          - '06'
          - '12'
          - '24'
      responses:
        200:
          description: successful operation
          content:
            text/plain:
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
  /api/data/areafcst:
    get:
      tags:
      - Weather Data
      summary: Get US Area Forecasts
      description: Text Area Forecasts for the United States outside the contiguous states (Alaska)
      parameters:
      - name: region
        in: query
        description: "Date\n * `aknorth` - Northern half of Alaska\n * `akcentral` - Interior Alaska\n * `aksouth` - Southcentral Alaska\n * `aksouthwest` - Alaska Peninsula\n * `aksoutheast` - Eastern Gulf of Alaska\n * `akpanhandle` - Alaska\n"
        required: true
        schema:
          type: string
          enum:
          - aknorth
          - akcentral
          - akaleutian
          - aksouth
          - aksouthwest
          - aksoutheast
          - akpanhandle
      responses:
        200:
          description: successful operation
          content:
            text/plain:
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
  /api/data/fcstdisc:
    get:
      tags:
      - Weather Data
      summary: Get US Forecast Discussions
      description: Aviation Forecast Discussions issued by NWS Weather Forecast Offices. Returns aviation section or full discussion issued within the past six hours.
      parameters:
      - name: cwa
        in: query
        description: County Warning Area (WFO)
        required: false
        examples:
          '-':
            value: ''
          KEAX:
            summary: Kansas City
            value: keax
        schema:
          type: string
      - name: type
        in: query
        description: "Type of output:\n * `afd` - aviation discussion\n * `af` - full discussion\n"
        required: false
        schema:
          type: string
          enum:
          - afd
          - af
      responses:
        200:
          description: successful operation
          content:
            text/plain:
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
  /api/data/mis:
    get:
      tags:
      - Weather Data
      summary: Get Meteorological Information Statement
      description: Meteorological Information Statements issued by NWS Center Weather Service Units (CWSU)
      parameters:
      - name: loc
        in: query
        description: CWSU
        required: false
        examples:
          '-':
            value: ''
          zkc:
            summary: Kansas City
            value: zkc
        schema:
          type: string
      - name: format
        in: query
        description: Format
        required: false
        explode: true
        schema:
          type: string
          enum:
          - json
          - text
          default: text
      responses:
        200:
          description: successful operation
          content:
            text/plain:
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
  /api/data/dataserver:
    get:
      tags:
      - Weather Data
      summary: Get Data Server
      description: Compatibility layer with previous Text Data Service. Station identifiers or a bounding box, as well as a time selection, are required.
      parameters:
      - name: requestType
        in: query
        required: true
        schema:
          type: string
          enum:
          - retrieve
      - name: dataSource
        in: query
        required: true
        schema:
          type: string
          enum:
          - metars
          - tafs
          - aircraftreports
          - airsigmets
          - gairmets
      - name: stationString
        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
      - name: boundingBox
        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
      - name: startTime
        in: query
        description: "Start time\n * `yyyymmdd_hhmm`\n * `yyyy-mm-ddThh:mm:ssZ`\n"
        required: false
        examples:
          '-':
            value: ''
          epoch_secs:
            summary: A Unix epoch time in seconds
            value: 1703052000
          iso_date:
            summary: ISO8601 Date
            value: 2023-12-23 23:57:29+00:00
        schema:
          type: string
      - name: endTime
        in: query
        description: "End time\n * `yyyymmdd_hhmm`\n * `yyyy-mm-ddThh:mm:ssZ`\n"
        required: false
        examples:
          '-':
            value: ''
          epoch_secs:
            summary: A Unix epoch time in seconds
            value: 1703383049
          iso_date:
            summary: ISO8601 Date
            value: 2023-12-20 00:00:00+00:00
        schema:
          type: string
      - name: hoursBeforeNow
        in: query
        description: Number of hours before now to search
        required: false
        explode: true
        schema:
          type: number
      - name: format
        in: query
        description: Output format (TAFs not available in CSV format)
        explode: false
        schema:
          type: string
          default: xml
          enum:
          - xml
          - csv
      - name: mostRecentForEachStation
        in: query
        description: Most recent per station (METARs and TAFs only)
        required: false
        explode: false
        schema:
          type: string
          enum:
          - constraint
          - postfilter
      - name: radialDistance
        in: query
        description: Circular bounds defined by latitude, longitude and radial distance in statute miles (PIREPS only)
        required: false
        examples:
          '-':
            value: ''
          radial:
            summary: A small area around Denver
            value: 20;-105,39
        schema:
          type: string
      responses:
        200:
          description: successful operation
        400:
          $ref: '#/components/responses/400'
components:
  parameters:
    JSONGeoIWXXM:
      name: format
      in: query
      description: Format
      required: false
      explode: true
      schema:
        type: string
        enum:
        - json
        - geojson
        - iwxxm
        default: json
    date:
      name: date
      in: query
      description: String (`yyyymmdd_hhmm`) or ISO 8601 Date (`yyyy-mm-ddThh:mm:ssZ`)
      required: false
      explode: true
      examples:
        '-':
          value: ''
        datim:
          summary: Date/time string
          value: 202312200000
        iso_date:
          summary: ISO 8601 Date
          value: 2023-12-20 00:00:00+00:00
      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
    hours:
      name: hours
      in: query
      description: Hours back to search
      required: false
      explode: true
      schema:
        type: number
        default: 1.5
    RawGeo:
      name: format
      in: query
      description: Format
      required: false
      explode: true
      schema:
        type: string
        enum:
        - raw
        - 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
    RawJSONGeoXMLIWXXM:
      name: format
      in: query
      description: Format
      required: false
      explode: true
      schema:
        type: string
        enum:
        - raw
        - json
        - geojson
        - xml
        - iwxxm
        default: raw
    RawJSONGeo:
      name: format
      in: query
      description: Format
      required: false
      explode: true
      schema:
        type: string
        enum:
        - raw
        - json
        - geojson
        default: raw
  schemas:
    CwaGeoJSON:
      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:
                  cwsu:
                    type: string
                    description: Issuing CWSU identifier
                    examples:
                    - ZJX
                  name:
                    type: string
                    description: Issuing CWSU name
                    examples:
                    - Jacksonville
                  validTimeFrom:
                    type: integer
                    examples:
                    - 1733364000
                  validTimeTo:
                    type: integer
                    examples:
                    - 1733378400
                  hazard:
                    type: string
                    description: Hazard type
                    examples:
                    - IFR
                  seriesId:
                    type: integer
                    examples:
                    - 101
                  qualifier:
                    type: string
                  base:
                    type: integer
                  top:
                    type: integer
                  cwaText:
                    type: string
              geometry:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                    - Polygon
                  coordinates:
                    type: array
                    minItems: 4
                    items:
                      type: number
    GairmetJSON:
      type: array
      items:
        type: object
        properties:
          tag:
            type: string
            description: Forecast component tag
            examples:
            - 1C
          forecastHour:
            type: integer
            examples:
            - 0
          validTime:
            type: string
            examples:
            - 2025-09-30 03:00:00+00:00
          hazard:
            type: string
            description: Hazard type
            examples:
            - IFR
          geometryType:
            type: string
            enum:
            - AREA
            - LINE
          latlonpairs:
            type: integer
            examples:
            - 23
          due_to:
            type: string
            examples:
            - CIG BLW 010/VIS BLW 3SM PCPN/BR
          receiptTime:
            type: integer
            examples:
            - 1759200749
          issueTime:
            type: integer
            examples:
            - 1759200300
          expireTime:
            type: integer
            examples:
            - 1759222800
          product:
            type: string
            enum:
            - SIERRA
            - TANGO
            - ZULU
          coords:
            type: array
            items:
              type: object
              parameters:
                lat:
                  type: number
                lon:
                  type: number
    PIREPXML:
      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: PIREP
            properties:
              receipt_time:
                type: string
                examples:
                - '2024-12-04T19:22:42.000Z'
              observation_time:
                type: string
                examples:
                - '2024-12-04T19:20:00.000Z'
              quality_control_flags:
                type: number
              aircraft_ref:
                type: string
                examples:
                - B738
              latitude:
                type: number
                examples:
                - '41.3032'
              longitude:
                type: number
                examples:
                - '-95.8941'
              altitude_ft_msl:
                type: number
                examples:
                - '36000'
              sky_condition:
                type: string
              turbulence_condition:
                properties:
                  turbulence_type:
                    type: string
                    xml:
                      attribute: true
                  turbulence_intensity:
                    type: string
                    xml:
                      attribute: true
                  turbulence_base_ft_msl:
                    type: string
                    xml:
                      attribute: true
                  turbulence_top_ft_msl:
                    type: string
                    xml:
                      attribute: true
                  turbulence_freq:
                    type: string
                    xml:
                      attribute: true
              icing_condition:
                properties:
                  icing_type:
                    type: string
                    xml:
                      attribute: true
                  icing_intensity:
                    type: string
                    xml:
                      attribute: true
                  icing_base_ft_msl:
                    type: number
                    xml:
                      attribute: true
                  icing_top_ft_msl:
                    type: number
                    xml:
                      attribute: true
                  turbulence_freq:
                    type: string
                    xml:
                      attribute: true
              visibility_statute_mi:
                type: string
              wx_string:
                type: string
              temp_c:
                type: number
                description: Temperature in Celsius
                examples:
                - 14.4
              wind_dir_degrees:
                description: Wind direction in degrees or VRB for variable winds
                anyOf:
                - type: integer
                - type: string
                examples:
                - 230
              wind_speed_kt:
                type: number
                description: Wind speed in knots
                examples:
                - 6
              vert_gust_kt:
                type: number
                description: Wind gust in knots
                examples:
                - 12
              pirep_type:
                type: string
                enum:
                - PIREP
                - Urgent PIREP
                - AIREP
                - AMDAR
                examples:
                - PIREP
              raw_text:
                type: string
    GairmetGeoJSON:
      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:
                  tag:
                    type: string
                    examples:
                    - 1C
                  forecastHour:
                    type: integer
                    examples:
                    - 0
                  receiptTime:
                    type: string
                    examples:
                    - 2025-09-30 02:52:29.446000+00:00
                  issueTime:
                    type: string
                    examples:
                    - 2025-09-30 02:45:00+00:00
                  validTime:
                    type: string
                    examples:
                    - 2025-09-30 03:00:00+00:00
                  hazard:
                    type: string
                    examples:
                    - IFR
                  due_to:
                    type: string
                    examples:
                    - CIG BLW 010/VIS BLW 3SM PCPN/BR
                  product:
                    type: string
                    enum:
                    - SIERRA
                    - TANGO
                  

# --- truncated at 32 KB (73 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/aviationweather/refs/heads/main/openapi/aviationweather-weather-data-api-openapi.yml