{ "openapi": "3.1.0", "info": { "title": "Airport Status API", "version": "1.0.0", "description": "Live FAA delays for US airports: closures, ground stops, ground delay programs and arrival and departure delays.\n\nLive US airport delays, straight from FAA air traffic control. Real-time National Airspace System status parsed into clean JSON: airport closures (with start and reopen times), ground stops (departures to an airport held on the ground), ground delay programs (with average and maximum delay), general arrival/departure delays (min/max and whether the delay is increasing or decreasing), plus the airspace flow programs and CTOPs that explain en-route holding. Ask for the whole national picture with per-category counts, just the list of currently affected airports, or one airport by code — FAA/IATA 3-letter or ICAO K-prefixed (KLAX works) — and a quiet airport answers with an explicit \"normal\" status rather than an empty object. Responses are edge-cached for 2 minutes, so you get near-real-time data at API speed without hammering the FAA. The delay layer for flight trackers, travel apps, airport pickup timing, ops dashboards and \"should I leave for the airport yet\" features — pairs with our Airports, Airlines and Aircraft APIs. US airports only (FAA coverage).", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/airport-status.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/airport-status" }, "servers": [ { "url": "https://api-airport-status.dataandapis.com" } ], "tags": [ { "name": "Transportation", "description": "Airport Status API belongs to the Transportation category of the Data and APIs catalog." } ], "paths": { "/v1/airport-status/delays": { "get": { "operationId": "affectedAirports", "summary": "Affected Airports", "description": "Affected Airports endpoint of the Airport Status API. Costs 2 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/airport-status/affected-airports" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "update_time": "Sun Sep 13 06:28:01 2026 GMT", "affected_airports": 5, "airports": [ { "airport": "ALO", "events": [ "closure" ] }, { "airport": "ASE", "events": [ "closure" ] }, { "airport": "GSP", "events": [ "closure" ] }, { "airport": "LAX", "events": [ "closure" ] }, { "airport": "SAN", "events": [ "closure" ] } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/airport-status/{code}": { "get": { "operationId": "airportStatus", "summary": "Airport Status", "description": "Airport Status endpoint of the Airport Status API. Costs 2 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/airport-status/airport-status" }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "example": "LAX" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "airport": "LAX", "update_time": "Sun Sep 13 06:28:01 2026 GMT", "status": "impacted", "closures": [ { "airport": "LAX", "reason": "!LAX 05/277 LAX AD AP CLSD TO NON SKED TRANSIENT GA ACFT EXC 24HR PPR CTC ATLANTIC AVIATION 310-258-9884 OR SIGNATURE AVIATION 310-410-9605 2605271826-2705281600", "start": "May 27 at 18:26 UTC.", "reopen": "May 28 at 16:00 UTC." } ], "ground_stops": [], "ground_delays": [], "arrival_departure_delays": [] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Airport Status API. Costs 2 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/airport-status/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "sources": [ { "slug": "faa-nas-status", "name": "FAA National Airspace System status", "publisher": "US Federal Aviation Administration", "licence": "US government work (public domain)", "source_url": "https://nasstatus.faa.gov/", "file_url": "https://nasstatus.faa.gov/api/airport-status-information", "cadence": "live feed; responses edge-cached 2 minutes" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/airport-status": { "get": { "operationId": "nationalStatus", "summary": "National Status", "description": "National Status endpoint of the Airport Status API. Costs 2 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/airport-status/national-status" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "update_time": "Sun Sep 13 06:28:01 2026 GMT", "counts": { "closures": 5, "ground_stops": 0, "ground_delays": 0, "arrival_departure_delays": 0, "airspace_flow_programs": 0, "ctops": 0 }, "closures": [ { "airport": "ALO", "reason": "!ALO 09/001 ALO AD AP CLSD EXC HEL 2609080900-2609230300", "start": "Sep 08 at 09:00 UTC.", "reopen": "Sep 23 at 03:00 UTC." }, { "airport": "GSP", "reason": "!GSP 09/009 GSP AD AP CLSD 2609120000-2609141200", "start": "Sep 12 at 00:00 UTC.", "reopen": "Sep 14 at 12:00 UTC." }, { "airport": "ASE", "reason": "!ASE 09/019 ASE AD AP CLSD EXC LIFE FLT HEL AND SAR HEL 30MIN PPR 970-379-8406 2609130500-2609131300", "start": "Sep 13 at 05:00 UTC.", "reopen": "Sep 13 at 13:00 UTC." }, { "airport": "LAX", "reason": "!LAX 05/277 LAX AD AP CLSD TO NON SKED TRANSIENT GA ACFT EXC 24HR PPR CTC ATLANTIC AVIATION 310-258-9884 OR SIGNATURE AVIATION 310-410-9605 2605271826-2705281600", "start": "May 27 at 18:26 UTC.", "reopen": "May 28 at 16:00 UTC." }, { "airport": "SAN", "reason": "!SAN 03/071 SAN AD AP CLSD TO NON SKED TRANSIENT GA ACFT EXC PPR 619-298-7704 2603181300-2610010800", "start": "Mar 18 at 13:00 UTC.", "reopen": "Oct 01 at 08:00 UTC." } ], "ground_stops": [], "ground_delays": [], "arrival_departure_delays": [], "airspace_flow_programs": [], "ctops": [], "coverage": "US airports (FAA National Airspace System)" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 2 tokens per call." } } }, "security": [ { "ApiKey": [] } ] }