{"openapi":"3.1.0","info":{"title":"Airports API","version":"1.0.0","description":"A worldwide airport database in one fast API: roughly 7,700 airports with IATA and ICAO codes, name, city, country, latitude and longitude, altitude and time zone. Look up any airport by its IATA (3-letter) or ICAO (4-letter) code, search by name, city or country, find the airports nearest to any coordinate within a radius (with great-circle distances, optionally only those with IATA codes), or list every airport in a country. Built on the open OpenFlights/OurAirports dataset and served entirely in-memory, so responses are instant and the service is always available. Ideal for travel and booking apps, flight trackers, logistics and routing, maps and location features.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/airports-api","description":"oanor gateway"}],"tags":[{"name":"Airports"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/airport":{"get":{"operationId":"get_v1_airport","tags":["Airports"],"summary":"Airport by IATA / ICAO code","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"3-letter IATA or 4-letter ICAO","schema":{"type":"string"},"example":"LAX"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"city":"Los Angeles","iata":"LAX","icao":"KLAX","name":"Los Angeles International Airport","type":"airport","country":"United States","latitude":33.9425,"timezone":"America/Los_Angeles","longitude":-118.408,"utc_offset":-8,"altitude_ft":125},"meta":{"timestamp":"2026-05-30T18:16:51.521Z","request_id":"3927c8da-1449-4fe5-9ffc-a9044c6578e8"},"status":"ok","message":"Airport retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Airports"],"summary":"Airports in a country","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"Country name","schema":{"type":"string"},"example":"Germany"},{"name":"limit","in":"query","required":false,"description":"1-500 (default 50)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"country":"Germany","airports":[{"city":"Bautzen","icao":"EDAB","name":"Flugplatz Bautzen","type":"airport","country":"Germany","latitude":51.19361,"timezone":"Europe/Berlin","longitude":14.51972,"utc_offset":1,"altitude_ft":568},{"city":"Altenburg","iata":"AOC","icao":"EDAC","name":"Altenburg-Nobitz Airport","type":"airport","country":"Germany","latitude":50.98195,"timezone":"Europe/Berlin","longitude":12.50639,"utc_offset":1,"altitude_ft":640},{"city":"Dessau","icao":"EDAD","name":"Dessau Airfield","type":"airport","country":"Germany","latitude":51.83169,"timezone":"Europe/Berlin","longitude":12.19096,"utc_offset":1,"altitude_ft":187},{"city":"Eisenhuettenstadt","icao":"EDAE","name":"Eisenhüttenstadt Airfield","type":"airport","country":"Germany","latitude":52.19586,"timezone":"Europe/Berlin","longitude":14.58753,"utc_offset":1,"altitude_ft":144},{"city":"Suhl","icao":"EDAK","name":"Großenhain Airport","type":"airport","country":"Germany","latitude":51.30806,"timezone":"Europe/Berlin","longitude":13.55556,"utc_offset":1,"altitude_ft":417},{"city":"Muehlhausen","icao":"EDAM","name":"Merseburg Airport","type":"airport","country":"Germany","latitude":51.36306,"timezone":"Europe/Berlin","longitude":11.94083,"utc_offset":1,"altitude_ft":341},{"city":"Halle","icao":"EDAQ","name":"Halle-Oppin Airport","type":"airport","country":"Germany","latitude":51.55222,"timezone":"Europe/Berlin","longitude":12.05389,"utc_offset":1,"altitude_ft":348},{"city":"Riesa","iata":"IES","icao":"EDAU","name":"Riesa-Göhlis Airport","type":"airport","country":"Germany","latitude":51.29361,"timezone":"Europe/Berlin","longitude":13.35611,"utc_offset":1,"altitude_ft":322},{"city":"Rechlin-laerz","iata":"REB","icao":"EDAX","name":"Rechlin-Lärz Airport","type":"airport","country":"Germany","latitude":53.30639,"timezone":"Europe/Berlin","longitude":12.75222,"utc_offset":1,"altitude_ft":220},{"city":"Strausberg","icao":"EDAY","name":"Strausberg Airport","type":"airport","country":"Germany","latitude":52.58055,"timezone":"Europe/Berlin","longitude":13.91667,"utc_offset":1,"altitude_ft":262},{"city":"Schoenhagen","iata":"QXH","icao":"EDAZ","name":"Schönhagen Airport","type":"airport","country":"Germany","latitude":52.20361,"timezone":"Europe/Berlin","longitude":13.15639,"utc_offset":1,"altitude_ft":152},{"city":"Barth","iata":"BBH","icao":"EDBH","name":"Barth Airport","type":"airport","country":"Germany","latitude":54.33825,"timezone":"Europe/Berlin","longitude":12.71051,"utc_offset":1,"altitude_ft":23},{"city":"Jena","icao":"EDBJ","name":"Jena-Schöngleina Airfield","type":"airport","country":"Germany","latitude":50.91528,"timezone":"Europe/Berlin","longitude":11.71444,"utc_offset":1,"altitude_ft":1247},{"city":"Kyritz","icao":"EDBK","name":"Kyritz Airport","type":"airport","country":"Germany","latitude":52.91889,"timezone":"Europe/Berlin","longitude":12.42528,"utc_offset":1,"altitude_ft":131},{"city":"Magdeburg","iata":"ZMG","icao":"EDBM","name":"Magdeburg \"City\" Airport","type":"airport","country":"Germany","latitude":52.07361,"timezone":"Europe/Berlin","longitude":11.62639,"utc_offset":1,"altitude_ft":259},{"city":"Rothenburg/ol","icao":"EDBR","name":"Rothenburg/Görlitz Airport","type":"airport","country":"Germany","latitude":51.36333,"timezone":"Europe/Berlin","longitude":14.95,"utc_offset":1,"altitude_ft":518},{"city":"Anklam","icao":"EDCA","name":"Anklam Airfield","type":"airport","country":"Germany","latitude":53.83278,"timezone":"Europe/Berlin","longitude":13.66861,"utc_offset":1,"altitude_ft":16},{"city":"Cottbus","iata":"CBU","icao":"EDCD","name":"Cottbus-Drewitz Airport","type":"airport","country":"Germany","latitude":51.88944,"timezone":"Europe/Berlin","longitude":14.53194,"utc_offset":1,"altitude_ft":272},{"city":"Kamenz","icao":"EDCM","name":"Kamenz Airport","type":"airport","country":"Germany","latitude":51.29694,"timezone":"Europe/Berlin","longitude":14.1275,"utc_offset":1,"altitude_ft":495},{"city":"Berlin","iata":"SXF","icao":"EDDB","name":"Berlin-Schönefeld Airport","type":"airport","country":"Germany","latitude":52.38,"timezone":"Europe/Berlin","longitude":13.5225,"utc_offset":1,"altitude_ft":157},{"city":"Dresden","iata":"DRS","icao":"EDDC","name":"Dresden Airport","type":"airport","country":"Germany","latitude":51.1328,"timezone":"Europe/Berlin","longitude":13.7672,"utc_offset":1,"altitude_ft":755},{"city":"Erfurt","iata":"ERF","icao":"EDDE","name":"Erfurt Airport","type":"airport","country":"Germany","latitude":50.9798,"timezone":"Europe/Berlin","longitude":10.9581,"utc_offset":1,"altitude_ft":1036},{"city":"Frankfurt","iata":"FRA","icao":"EDDF","name":"Frankfurt am Main Airport","type":"airport","country":"Germany","latitude":50.03333,"timezone":"Europe/Berlin","longitude":8.57056,"utc_offset":1,"altitude_ft":364},{"city":"Munster","iata":"FMO","icao":"EDDG","name":"Münster Osnabrück Airport","type":"airport","country":"Germany","latitude":52.1346,"timezone":"Europe/Berlin","longitude":7.68483,"utc_offset":1,"altitude_ft":160},{"city":"Hamburg","iata":"HAM","icao":"EDDH","name":"Hamburg Airport","type":"airport","country":"Germany","latitude":53.6304,"timezone":"Europe/Berlin","longitude":9.98823,"utc_offset":1,"altitude_ft":53},{"city":"Berlin","iata":"THF","icao":"EDDI","name":"Berlin-Tempelhof International Airport","type":"airport","country":"Germany","latitude":52.473,"timezone":"Europe/Berlin","longitude":13.4039,"utc_offset":1,"altitude_ft":167},{"city":"Cologne","iata":"CGN","icao":"EDDK","name":"Cologne Bonn Airport","type":"airport","country":"Germany","latitude":50.8659,"timezone":"Europe/Berlin","longitude":7.14274,"utc_offset":1,"altitude_ft":302},{"city":"Duesseldorf","iata":"DUS","icao":"EDDL","name":"Düsseldorf Airport","type":"airport","country":"Germany","latitude":51.2895,"timezone":"Europe/Berlin","longitude":6.76678,"utc_offset":1,"altitude_ft":147},{"city":"Munich","iata":"MUC","icao":"EDDM","name":"Munich Airport","type":"airport","country":"Germany","latitude":48.3538,"timezone":"Europe/Berlin","longitude":11.7861,"utc_offset":1,"altitude_ft":1487},{"city":"Nuernberg","iata":"NUE","icao":"EDDN","name":"Nuremberg Airport","type":"airport","country":"Germany","latitude":49.4987,"timezone":"Europe/Berlin","longitude":11.07806,"utc_offset":1,"altitude_ft":1046},{"city":"Leipzig","iata":"LEJ","icao":"EDDP","name":"Leipzig/Halle Airport","type":"airport","country":"Germany","latitude":51.42389,"timezone":"Europe/Berlin","longitude":12.23639,"utc_offset":1,"altitude_ft":465},{"city":"Saarbruecken","iata":"SCN","icao":"EDDR","name":"Saarbrücken Airport","type":"airport","country":"Germany","latitude":49.2146,"timezone":"Europe/Berlin","longitude":7.10951,"utc_offset":1,"altitude_ft":1058},{"city":"Stuttgart","iata":"STR","icao":"EDDS","name":"Stuttgart Airport","type":"airport","country":"Germany","latitude":48.6899,"timezone":"Europe/Berlin","longitude":9.22196,"utc_offset":1,"altitude_ft":1276},{"city":"Berlin","iata":"TXL","icao":"EDDT","name":"Berlin-Tegel Airport","type":"airport","country":"Germany","latitude":52.5597,"timezone":"Europe/Berlin","longitude":13.2877,"utc_offset":1,"altitude_ft":122},{"city":"Hannover","iata":"HAJ","icao":"EDDV","name":"Hannover Airport","type":"airport","country":"Germany","latitude":52.4611,"timezone":"Europe/Berlin","longitude":9.68508,"utc_offset":1,"altitude_ft":183},{"city":"Bremen","iata":"BRE","icao":"EDDW","name":"Bremen Airport","type":"airport","country":"Germany","latitude":53.0475,"timezone":"Europe/Berlin","longitude":8.78667,"utc_offset":1,"altitude_ft":14},{"city":"Egelsbach","iata":"QEF","icao":"EDFE","name":"Frankfurt-Egelsbach Airport","type":"airport","country":"Germany","latitude":49.96,"timezone":"Europe/Berlin","longitude":8.64583,"utc_offset":1,"altitude_ft":384},{"city":"Hahn","iata":"HHN","icao":"EDFH","name":"Frankfurt-Hahn Airport","type":"airport","country":"Germany","latitude":49.9487,"timezone":"Europe/Berlin","longitude":7.26389,"utc_offset":1,"altitude_ft":1649},{"city":"Mannheim","iata":"MHG","icao":"EDFM","name":"Mannheim-City Airport","type":"airport","country":"Germany","latitude":49.47306,"timezone":"Europe/Berlin","longitude":8.51417,"utc_offset":1,"altitude_ft":308},{"city":"Allendorf","icao":"EDFQ","name":"Allendorf/Eder Airport","type":"airport","country":"Germany","latitude":51.035,"timezone":"Europe/Berlin","longitude":8.68083,"utc_offset":1,"altitude_ft":1158},{"city":"Worms","icao":"EDFV","name":"Worms Airport","type":"airport","country":"Germany","latitude":49.60695,"timezone":"Europe/Berlin","longitude":8.36833,"utc_offset":1,"altitude_ft":295},{"city":"Mainz","icao":"EDFZ","name":"Mainz-Finthen Airport","type":"airport","country":"Germany","latitude":49.9675,"timezone":"Europe/Berlin","longitude":8.14722,"utc_offset":1,"altitude_ft":525},{"city":"Eisenach","iata":"EIB","icao":"EDGE","name":"Eisenach-Kindel Airport","type":"airport","country":"Germany","latitude":50.9916,"timezone":"Europe/Berlin","longitude":10.47973,"utc_offset":1,"altitude_ft":1112},{"city":"Siegerland","iata":"SGE","icao":"EDGS","name":"Siegerland Airport","type":"airport","country":"Germany","latitude":50.7077,"timezone":"Europe/Berlin","longitude":8.08297,"utc_offset":1,"altitude_ft":1966},{"city":"Hamburg","iata":"XFW","icao":"EDHI","name":"Hamburg-Finkenwerder Airport","type":"airport","country":"Germany","latitude":53.53528,"timezone":"Europe/Berlin","longitude":9.83556,"utc_offset":1,"altitude_ft":23},{"city":"Kiel","iata":"KEL","icao":"EDHK","name":"Kiel-Holtenau Airport","type":"airport","country":"Germany","latitude":54.37944,"timezone":"Europe/Berlin","longitude":10.14528,"utc_offset":1,"altitude_ft":102},{"city":"Luebeck","iata":"LBC","icao":"EDHL","name":"Lübeck Blankensee Airport","type":"airport","country":"Germany","latitude":53.8054,"timezone":"Europe/Berlin","longitude":10.7192,"utc_offset":1,"altitude_ft":53},{"city":"Dahlemer Binz","icao":"EDKV","name":"Flugplatz Dahlemer Binz","type":"airport","country":"Germany","latitude":50.40556,"timezone":"Europe/Berlin","longitude":6.52889,"utc_offset":1,"altitude_ft":1896},{"city":"Meinerzhagen","icao":"EDKZ","name":"Meinerzhagen Airport","type":"airport","country":"Germany","latitude":51.1,"timezone":"Europe/Berlin","longitude":7.6,"utc_offset":1,"altitude_ft":1549},{"city":"Arnsberg","icao":"EDLA","name":"Arnsberg-Menden Airport","type":"airport","country":"Germany","latitude":51.48389,"timezone":"Europe/Berlin","longitude":7.89833,"utc_offset":1,"altitude_ft":794}]},"meta":{"timestamp":"2026-05-30T18:16:51.598Z","request_id":"c5aa6633-c536-4b56-8d19-f37e1fb5ed0f"},"status":"ok","message":"Country airports retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/nearby":{"get":{"operationId":"get_v1_nearby","tags":["Airports"],"summary":"Airports near a coordinate","description":"","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"string"},"example":"51.5"},{"name":"lon","in":"query","required":true,"description":"Longitude","schema":{"type":"string"},"example":"-0.13"},{"name":"radius_km","in":"query","required":false,"description":"Radius in km (default 100)","schema":{"type":"string"},"example":"100"},{"name":"limit","in":"query","required":false,"description":"1-50 (default 10)","schema":{"type":"string"},"example":"10"},{"name":"iata_only","in":"query","required":false,"description":"Only airports with an IATA code","schema":{"type":"string"},"example":"false"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"airports":[{"city":"London","icao":"EGLW","name":"London Heliport","type":"airport","country":"United Kingdom","latitude":51.46972,"timezone":"Europe/London","longitude":-0.17944,"utc_offset":0,"altitude_ft":18,"distance_km":4.8},{"city":"London","iata":"LCY","icao":"EGLC","name":"London City Airport","type":"airport","country":"United Kingdom","latitude":51.5053,"timezone":"Europe/London","longitude":0.05528,"utc_offset":0,"altitude_ft":19,"distance_km":12.8},{"city":"Northolt","iata":"NHT","icao":"EGWU","name":"RAF Northolt","type":"airport","country":"United Kingdom","latitude":51.553,"timezone":"Europe/London","longitude":-0.41817,"utc_offset":0,"altitude_ft":124,"distance_km":20.8},{"city":"Biggin Hill","iata":"BQH","icao":"EGKB","name":"London Biggin Hill Airport","type":"airport","country":"United Kingdom","latitude":51.3308,"timezone":"Europe/London","longitude":0.0325,"utc_offset":0,"altitude_ft":598,"distance_km":21.9},{"city":"Elstree","icao":"EGTR","name":"Elstree Airfield","type":"airport","country":"United Kingdom","latitude":51.6558,"timezone":"Europe/London","longitude":-0.32583,"utc_offset":0,"altitude_ft":332,"distance_km":22},{"city":"London","iata":"LHR","icao":"EGLL","name":"London Heathrow Airport","type":"airport","country":"United Kingdom","latitude":51.4706,"timezone":"Europe/London","longitude":-0.46194,"utc_offset":0,"altitude_ft":83,"distance_km":23.2},{"city":"Stapleford","icao":"EGSG","name":"Stapleford Aerodrome","type":"airport","country":"United Kingdom","latitude":51.6525,"longitude":0.15583,"utc_offset":0,"altitude_ft":183,"distance_km":26},{"city":"North Weald","icao":"EGSX","name":"North Weald Airport","type":"airport","country":"United Kingdom","latitude":51.7217,"timezone":"Europe/London","longitude":0.15417,"utc_offset":0,"altitude_ft":321,"distance_km":31.5},{"city":"Redhill","iata":"KRH","icao":"EGKR","name":"Redhill Aerodrome","type":"airport","country":"United Kingdom","latitude":51.2136,"timezone":"Europe/London","longitude":-0.13861,"utc_offset":0,"altitude_ft":222,"distance_km":31.9},{"city":"Panshanger","icao":"EGLG","name":"Panshanger Aerodrome","type":"airport","country":"United Kingdom","latitude":51.8025,"longitude":-0.15806,"utc_offset":0,"altitude_ft":249,"distance_km":33.7}],"latitude":51.5,"longitude":-0.13,"radius_km":100},"meta":{"timestamp":"2026-05-30T18:16:51.679Z","request_id":"66d57ded-b4bd-4fe7-b8b5-a32ab637e6de"},"status":"ok","message":"Nearby airports retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Airports"],"summary":"Search by name, city or country","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"London"},{"name":"limit","in":"query","required":false,"description":"1-100 (default 20)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":13,"query":"london","airports":[{"city":"London","iata":"YXU","icao":"CYXU","name":"London Airport","type":"airport","country":"Canada","latitude":43.0356,"timezone":"America/Toronto","longitude":-81.1539,"utc_offset":-5,"altitude_ft":912},{"city":"Londonderry","iata":"LDY","icao":"EGAE","name":"City of Derry Airport","type":"airport","country":"United Kingdom","latitude":55.0428,"timezone":"Europe/London","longitude":-7.16111,"utc_offset":0,"altitude_ft":22},{"city":"London","iata":"LTN","icao":"EGGW","name":"London Luton Airport","type":"airport","country":"United Kingdom","latitude":51.8747,"timezone":"Europe/London","longitude":-0.36833,"utc_offset":0,"altitude_ft":526},{"city":"Biggin Hill","iata":"BQH","icao":"EGKB","name":"London Biggin Hill Airport","type":"airport","country":"United Kingdom","latitude":51.3308,"timezone":"Europe/London","longitude":0.0325,"utc_offset":0,"altitude_ft":598},{"city":"London","iata":"LGW","icao":"EGKK","name":"London Gatwick Airport","type":"airport","country":"United Kingdom","latitude":51.1481,"timezone":"Europe/London","longitude":-0.19028,"utc_offset":0,"altitude_ft":202},{"city":"London","iata":"LCY","icao":"EGLC","name":"London City Airport","type":"airport","country":"United Kingdom","latitude":51.5053,"timezone":"Europe/London","longitude":0.05528,"utc_offset":0,"altitude_ft":19},{"city":"London","iata":"LHR","icao":"EGLL","name":"London Heathrow Airport","type":"airport","country":"United Kingdom","latitude":51.4706,"timezone":"Europe/London","longitude":-0.46194,"utc_offset":0,"altitude_ft":83},{"city":"London","iata":"STN","icao":"EGSS","name":"London Stansted Airport","type":"airport","country":"United Kingdom","latitude":51.885,"timezone":"Europe/London","longitude":0.235,"utc_offset":0,"altitude_ft":348},{"city":"East London","iata":"ELS","icao":"FAEL","name":"Ben Schoeman Airport","type":"airport","country":"South Africa","latitude":-33.0356,"timezone":"Africa/Johannesburg","longitude":27.8259,"utc_offset":2,"altitude_ft":435},{"city":"Groton CT","iata":"GON","icao":"KGON","name":"Groton New London Airport","type":"airport","country":"United States","latitude":41.3301,"timezone":"America/New_York","longitude":-72.0451,"utc_offset":-5,"altitude_ft":9},{"city":"London","icao":"EGLW","name":"London Heliport","type":"airport","country":"United Kingdom","latitude":51.46972,"timezone":"Europe/London","longitude":-0.17944,"utc_offset":0,"altitude_ft":18},{"city":"London","iata":"LOZ","icao":"KLOZ","name":"London-Corbin Airport/Magee Field","type":"airport","country":"United States","latitude":37.0822,"timezone":"America/New_York","longitude":-84.0849,"utc_offset":-5,"altitude_ft":1212},{"city":"London","icao":"KUYF","name":"Madison County Airport","type":"airport","country":"United States","latitude":39.9327,"longitude":-83.462,"utc_offset":-5,"altitude_ft":1082}]},"meta":{"timestamp":"2026-05-30T18:16:51.774Z","request_id":"0ae60b15-1806-4257-8cec-7959e94b8b5c"},"status":"ok","message":"Search completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":750,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":400,"monthly_call_quota":20000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1300,"monthly_call_quota":120000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3600,"monthly_call_quota":600000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/airports-api"}