The AviationService provides APIs for accessing current airport delay alerts from the FAA (Federal Aviation Administration) and Eurocontrol.
Base Path ListAirportDelays Retrieves current airport delay alerts with filtering by region and severity.
Endpoint: GET /api/aviation/v1/list-airport-delaysRequest Parameters Maximum items per page (1-100)
Optional region filter: AIRPORT_REGION_AMERICAS, AIRPORT_REGION_EUROPE, AIRPORT_REGION_APAC, AIRPORT_REGION_MENA, or AIRPORT_REGION_AFRICA
Optional minimum severity filter: FLIGHT_DELAY_SEVERITY_NORMAL, FLIGHT_DELAY_SEVERITY_MINOR, FLIGHT_DELAY_SEVERITY_MODERATE, FLIGHT_DELAY_SEVERITY_MAJOR, or FLIGHT_DELAY_SEVERITY_SEVERE
Response The list of airport delay alerts IATA airport code (e.g., “JFK”)
ICAO airport code (e.g., “KJFK”)
City where the airport is located
Country code (ISO 3166-1 alpha-2)
Type of delay: FLIGHT_DELAY_TYPE_GROUND_STOP, FLIGHT_DELAY_TYPE_GROUND_DELAY, FLIGHT_DELAY_TYPE_DEPARTURE_DELAY, FLIGHT_DELAY_TYPE_ARRIVAL_DELAY, FLIGHT_DELAY_TYPE_GENERAL, or FLIGHT_DELAY_TYPE_CLOSURE
Percentage of delayed flights
Number of cancelled flights
Human-readable reason for delays
Data source: FLIGHT_DELAY_SOURCE_FAA, FLIGHT_DELAY_SOURCE_EUROCONTROL, or FLIGHT_DELAY_SOURCE_COMPUTED
Last data update time, as Unix epoch milliseconds
Example Request curl "https://your-domain.com/api/aviation/v1/list-airport-delays?region=AIRPORT_REGION_AMERICAS&min_severity=FLIGHT_DELAY_SEVERITY_MODERATE&page_size=50"
Example Response { "alerts" : [ { "id" : "jfk-delay-20240301" , "iata" : "JFK" , "icao" : "KJFK" , "name" : "John F. Kennedy International Airport" , "city" : "New York" , "country" : "US" , "location" : { "latitude" : 40.6413 , "longitude" : -73.7781 }, "region" : "AIRPORT_REGION_AMERICAS" , "delay_type" : "FLIGHT_DELAY_TYPE_DEPARTURE_DELAY" , "severity" : "FLIGHT_DELAY_SEVERITY_MODERATE" , "avg_delay_minutes" : 32 , "delayed_flights_pct" : 68.5 , "cancelled_flights" : 12 , "total_flights" : 287 , "reason" : "Weather: Low visibility and strong winds" , "source" : "FLIGHT_DELAY_SOURCE_FAA" , "updated_at" : 1709251200000 }, { "id" : "ord-delay-20240301" , "iata" : "ORD" , "icao" : "KORD" , "name" : "Chicago O'Hare International Airport" , "city" : "Chicago" , "country" : "US" , "location" : { "latitude" : 41.9742 , "longitude" : -87.9073 }, "region" : "AIRPORT_REGION_AMERICAS" , "delay_type" : "FLIGHT_DELAY_TYPE_GROUND_DELAY" , "severity" : "FLIGHT_DELAY_SEVERITY_MAJOR" , "avg_delay_minutes" : 58 , "delayed_flights_pct" : 82.3 , "cancelled_flights" : 34 , "total_flights" : 412 , "reason" : "Snow and ice accumulation on runways" , "source" : "FLIGHT_DELAY_SOURCE_FAA" , "updated_at" : 1709251800000 } ], "pagination" : { "cursor" : "eyJvZmZzZXQiOjUwfQ==" , "has_more" : true } }
Delay Severity Levels The FlightDelaySeverity enum provides standardized severity classifications:
NORMAL : Normal operations with no delaysMINOR : Minor delays under 15 minutesMODERATE : Moderate delays 15-45 minutesMAJOR : Major delays 45-90 minutesSEVERE : Severe delays over 90 minutes
Delay Types The FlightDelayType enum classifies different types of delays:
GROUND_STOP : No departures or arrivals permittedGROUND_DELAY : Ground delay program in effectDEPARTURE_DELAY : Delays affecting departing flightsARRIVAL_DELAY : Delays affecting arriving flightsGENERAL : General delay conditionCLOSURE : Airport or airspace closure