openapi: 3.0.1
info:
  title: Airport Status Web Service
  description: FAA Airport Status Web Service API
  contact:
    name: Airport Status Web Service (ASWS)
    url: http://fly.faa.gov
    email: edai-aero@faa.gov
  license:
    name: Creative Commons 0 (CC0)
    url: https://creativecommons.org/publicdomain/zero/1.0/legalcode
  version: 1.2.1
servers:
- url: https://external.apic4e.faa.gov
- url: https://external-api.faa.gov
tags:
- name: FAA Airport Status Service
paths:
  /api/airport/delays:
    get:
      tags:
      - FAA Airport Status Service
      summary: Get airport delay summary for major US national airports.
      description: "The airport status is retrieved from fly.faa.gov and is provided\
        \ in a format that can be used by applications that require airport status\
        \ data.Delays will be returned for the following airports: BOS, LGA, TEB,\
        \ EWR, JFK, PHL, PIT, IAD, BWI, DCA, RDU, CLT, ATL, MCO, TPA, MCO, FLL, MIA,\
        \ DTW, CLE, MDW, ORD, IND, CVG, BNA, MEM, STL, MCI, MSP, DFW, IAH, DEN, SLC,\
        \ PHX, LAS, SAN, LAX, SJC, SFO, PDX, SEA"
      operationId: getDelays
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Delays"
            application/xml:
              schema:
                $ref: "#/components/schemas/Delays"
        "404":
          description: Airport delays from http://www.fly.faa.gov are unavailable
          content: {}
        "500":
          description: Airport information from http://www.fly.faa.gov returned an
            error response
          content: {}
  /api/airport/status/{airportCode}:
    get:
      tags:
      - FAA Airport Status Service
      summary: Get airport status based on path parameter provided on the API call.
        The path parameter is an IATA airport code.
      description: "The airport status is retrieved from fly.faa.gov and is provided\
        \ in a format that can be used by applications that require airport status\
        \ data.Available airports include the following: BOS, LGA, TEB, EWR, JFK,\
        \ PHL, PIT, IAD, BWI, DCA, RDU, CLT, ATL, MCO, TPA, MCO, FLL, MIA, DTW, CLE,\
        \ MDW, ORD, IND, CVG, BNA, MEM, STL, MCI, MSP, DFW, IAH, DEN, SLC, PHX, LAS,\
        \ SAN, LAX, SJC, SFO, PDX, SEA"
      operationId: getAirportStatus
      parameters:
      - name: airportCode
        in: path
        required: true
        schema:
          type: string
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AirportStatus"
            application/xml:
              schema:
                $ref: "#/components/schemas/AirportStatus"
        "404":
          description: Delays are available only for major United States airports
          content: {}
components:
  schemas:
    Status:
      required:
      - avgDelay
      - closureBegin
      - closureEnd
      - endTime
      - maxDelay
      - minDelay
      - reason
      - trend
      - type
      type: object
      properties:
        type:
          type: string
          xml:
            name: Type
        reason:
          type: string
          xml:
            name: Reason
        avgDelay:
          type: string
          xml:
            name: AvgDelay
        closureEnd:
          type: string
          xml:
            name: ClosureEnd
        closureBegin:
          type: string
          xml:
            name: ClosureBegin
        minDelay:
          type: string
          xml:
            name: MinDelay
        trend:
          type: string
          xml:
            name: Trend
        maxDelay:
          type: string
          xml:
            name: MaxDelay
        endTime:
          type: string
          xml:
            name: EndTime
      xml:
        name: Status
    Weather:
      type: object
      properties:
        content:
          type: array
          items:
            type: object
            properties: {}
      xml:
        name: Weather
    GroundDelay:
      required:
      - airport
      - avgTime
      - reason
      type: object
      properties:
        airport:
          type: string
          xml:
            name: airport
        avgTime:
          type: string
          xml:
            name: avgTime
        reason:
          type: string
          xml:
            name: reason
      xml:
        name: GroundDelay
    GroundStop:
      required:
      - airport
      - endTime
      - reason
      type: object
      properties:
        airport:
          type: string
          xml:
            name: airport
        endTime:
          type: string
          xml:
            name: endTime
        reason:
          type: string
          xml:
            name: reason
      xml:
        name: GroundStop
    ArriveDepartDelay:
      required:
      - airport
      - maxTime
      - minTime
      - reason
      type: object
      properties:
        airport:
          type: string
          xml:
            name: airport
        maxTime:
          type: string
          xml:
            name: maxTime
        reason:
          type: string
          xml:
            name: reason
        minTime:
          type: string
          xml:
            name: minTime
      xml:
        name: ArriveDepartDelay
    Closure:
      required:
      - airport
      - reason
      - reopen
      type: object
      properties:
        airport:
          type: string
          xml:
            name: airport
        reason:
          type: string
          xml:
            name: reason
        reopen:
          type: string
          xml:
            name: reopen
      xml:
        name: closure
    GroundDelays:
      type: object
      properties:
        GroundDelay:
          type: array
          items:
            $ref: "#/components/schemas/GroundDelay"
    GroundStops:
      type: object
      properties:
        GroundStop:
          type: array
          items:
            $ref: "#/components/schemas/GroundStop"
    ArriveDepartDelays:
      type: object
      properties:
        ArriveDepartDelay:
          type: array
          items:
            $ref: "#/components/schemas/ArriveDepartDelay"
    Closures:
      type: object
      properties:
        Closure:
          type: array
          items:
            $ref: "#/components/schemas/Closure"
    Delays:
      type: object
      properties:
        GroundDelays:
          type: array
          items:
            $ref: "#/components/schemas/GroundDelays"
        GroundStops:
          type: array
          items:
            $ref: "#/components/schemas/GroundStops"
        ArriveDepartDelays:
          type: array
          items:
            $ref: "#/components/schemas/ArriveDepartDelays"
        Closures:
          type: array
          items:
            $ref: "#/components/schemas/Closures"
      xml:
        name: Delays
    AirportStatus:
      required:
      - city
      - delay
      - delayCount
      - iata
      - icao
      - name
      - state
      - supportedAirport
      - weather
      type: object
      properties:
        name:
          type: string
          xml:
            name: Name
        city:
          type: string
          xml:
            name: City
        state:
          type: string
          xml:
            name: State
        icao:
          type: string
          xml:
            name: ICAO
        iata:
          type: string
          xml:
            name: IATA
        supportedAirport:
          type: boolean
          xml:
            name: SupportedAirport
        delay:
          type: boolean
          xml:
            name: Delay
          default: false
        delayCount:
          type: integer
          xml:
            name: DelayCount
        status:
          type: array
          xml:
            name: Status
          items:
            $ref: "#/components/schemas/Status"
        weather:
          $ref: "#/components/schemas/Weather"
      xml:
        name: AirportStatus
x-original-swagger-version: "2.0"