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"