NOAA Weather Data API

openapi: 3.2.0
info:
  title: AviationWeather.gov Alerts Weather Data API
  description: Schema for public data API of AviationWeather.gov.
  termsOfService: /data/api/
  version: v4.0
servers:
- url: https://api.weather.gov
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Weather Data
  description: Decoded weather information
paths:
  /api/data/metar:
    get:
      tags:
      - Weather Data
      summary: METARs
      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: 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: 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: 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: 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: 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: 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: TFM Convective Forecast (TCF)
      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: 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: Wind/Temp 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: 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: 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: 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: 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:
  schemas:
    CloudInfo:
      type: array
      default: []
      description: Clouds
      items:
        type: object
        description: Cloud layer
        required:
        - cover
        - base
        properties:
          cover:
            type: string
            description: Cover coverage
            enum:
            - CLR
            - CAVOK
            - FEW
            - SCT
            - BKN
            - OVC
            - OVX
            examples:
            - BKN
          base:
            type: integer
            description: Cloud base in feet
            examples:
            - 11000
          top:
            type: integer
            description: Cloud top in feet
            examples:
            - 28000
    METARtext:
      type: string
      description: Raw text of observation
      examples:
      - KORD 032151Z 23006KT 10SM BKN110 OVC250 14/03 A3000 RMK AO2 SLP162 VIRGA OHD T01440028
    CwaJSON:
      type: array
      items:
        type: object
        properties:
          cwsu:
            type: string
            description: Issuing CWSU identifier
            examples:
            - ZJX
          name:
            type: string
            description: Issuing CWSU name
            examples:
            - Jacksonville
          receiptTime:
            type: string
            examples:
            - 2025-09-30 03:00:00+00:00
          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
          geom:
            type: string
            enum:
            - AREA
            - LINE
          coords:
            type: array
            items:
              type: object
              parameters:
                lat:
                  type: number
                lon:
                  type: number
          rawText:
            type: string
    METARproperties:
      type: object
      properties:
        icaoId:
          type: string
          default: ''
          description: ICAO identifier
          examples:
          - KORD
        receiptTime:
          type: string
          default: ''
          description: The time the observation was received (yyyy-mm-dd hh:mm:ss.sssZ)
          examples:
          - '2023-11-03 21:54:03.000Z'
        obsTime:
          type: integer
          description: The observation time (UNIX timestamp)
          examples:
          - 1699048260
        reportTime:
          type: string
          default: ''
          description: The time of the report (yyyy-mm-dd hh:mm:ss.sssZ)
          examples:
          - '2023-11-03 22:00:00.000Z'
        temp:
          type: number
          default: 0
          description: Temperature in Celsius
          examples:
          - 14.4
        dewp:
          type: number
          default: null
          description: Dewpoint temperature in Celsius
          examples:
          - 2.8
        wdir:
          minimum: 0
          default: null
          description: Wind direction in degrees or VRB for variable winds
          anyOf:
          - type: integer
          - type: string
          examples:
          - 230
        wspd:
          type: integer
          default: null
          minimum: 0
          description: Wind speed in knots
          examples:
          - 6
        wgst:
          type: integer
          default: null
          minimum: 0
          description: Wind gusts in knots
          examples:
          - 12
        visib:
          default: null
          description: Visibility in statute miles, 10+ is greater than 10 sm
          anyOf:
          - type: number
          - type: string
          examples:
          - 3
        altim:
          type: number
          default: null
          description: Altimeter setting in hectopascals
          examples:
          - 1016.3
        slp:
          type: number
          default: null
          description: Sea level pressure in hectopascals
          examples:
          - 1016.2
        wxString:
          type: string
          default: null
          description: Encoded present weather string
          examples:
          - -RA
        presTend:
          type: number
          default: null
          description: Pressure tendency over last 3 hours in hectopascals
          examples:
          - null
        maxT:
          type: number
          default: null
          description: Maximum temperature over last 6 hours in Celsius
          examples:
          - 23.4
        minT:
          type: number
          default: null
          description: Minimum temperature over last 6 hours in Celsius
          examples:
          - 12.3
        maxT24:
          type: number
          default: null
          description: Maximum temperature over last 24 hours in Celsius
          examples:
          - 23.4
        minT24:
          type: number
          default: null
          description: Minimum temperature over last 24 hours in Celsius
          examples:
          - 12.3
        precip:
          type: number
          default: null
          minimum: 0
          description: Precipitation over last hour in inches
          examples:
          - 0.01
        pcp3hr:
          type: number
          default: null
          minimum: 0
          description: Precipitation over last 3 hours in inches
          examples:
          - 0.1
        pcp6hr:
          type: number
          default: null
          minimum: 0
          description: Precipitation over last 6 hours in inches
          examples:
          - 0.23
        pcp24hr:
          type: number
          default: null
          minimum: 0
          description: Precipitation over last 24 hours in inches
          examples:
          - 0.53
        snow:
          type: number
          default: null
          minimum: 0
          description: Snow depth in inches
          examples:
          - 1
        vertVis:
          type: integer
          default: null
          minimum: 0
          description: Vertical visibility in feet
          examples:
          - 100
        metarType:
          type: string
          default: ''
          description: Type of encoding
          enum:
          - METAR
          - SPECI
          - SYNOP
          - BUOY
          - CMAN
          examples:
          - METAR
        rawOb:
          type: string
          default: ''
          description: Raw text of observation
          examples:
          - KORD 032151Z 23006KT 10SM BKN110 OVC250 14/03 A3000 RMK AO2 SLP162 VIRGA OHD T01440028
        lat:
          type: number
          default: 0
          description: Latitude of site in degrees
          examples:
          - 41.9602
        lon:
          type: number
          default: 0
          description: Longitude of site in degrees
          examples:
          - -87.9316
        elev:
          type: integer
          default: 0
          description: Elevation of site in meters
          examples:
          - 202
        name:
          type: string
          default: ''
          description: Full name of the site
          examples:
          - Chicago/O'Hare Intl
          - IL
          - US
        clouds:
          $ref: '#/components/schemas/CloudInfo'
        fltCat:
          type: string
          default: ''
          description: Flight category restriction
          examples:
          - IFR
    METARXML:
      xml:
        name: response
      type: object
      properties:
        request_index:
          type: number
        data_source:
          properties:
            name:
              type: string
              enum:
              - metar
              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: METAR
            properties:
              raw_text:
                type: string
              station_id:
                type: string
                description: Station identifier
                examples:
                - KORD
              observation_time:
                type: string
                description: The observation time
                examples:
                - '2023-11-03 22:00:00.000Z'
              latitude:
                type: number
                description: Latitude of site in degrees
                examples:
                - 41.9602
              longitude:
                type: number
                description: Longitude of site in degrees
                examples:
                - -87.9316
              temp_c:
                type: number
                description: Temperature in Celsius
                examples:
                - 14.4
              dewpoint_c:
                type: number
                description: Dewpoint temperature in Celsius
                examples:
                - 2.8
              wind_dir_degrees:
                minimum: 0
                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
              visibility_statute_mi:
                description: Visibility in statute miles, 10+ is greater than 10 sm
                anyOf:
                - type: number
                - type: string
                examples:
                - 3
              altim_in_hg:
                type: number
                description: Altimeter setting in inches of mercury
              sea_level_pressure_mb:
                type: number
                description: Mean sea level pressure in mb (hPa)
              quality_control_flags:
                type: object
                properties:
                  auto_station:
                    type: boolean
              flight_category:
                type: string
              metar_type:
                type: string
              elevation_m:
                type: number
    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
                    - ZULU
              geometry:
                type: object
                properties:
                  type:
                    type: string
                    enum

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