{"openapi":"3.1.0","info":{"title":"Airlines API","version":"1.0.0","description":"Search a database of 6,000+ airlines worldwide (OpenFlights open dataset). Find carriers by name and country, look one up by its IATA (2-letter) or ICAO (3-letter) code, and browse counts per country. Each record includes the airline name, codes, radio callsign, country and active status — ideal for travel apps, booking flows, flight dashboards and aviation tooling.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/airlines-api","description":"oanor gateway"}],"tags":[{"name":"Airlines"},{"name":"Countries"},{"name":"Meta"}],"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/airline":{"get":{"operationId":"get_v1_airline","tags":["Airlines"],"summary":"A single airline by IATA, ICAO or id","description":"","parameters":[{"name":"iata","in":"query","required":false,"description":"2-letter IATA code","schema":{"type":"string"},"example":"LH"},{"name":"icao","in":"query","required":false,"description":"3-letter ICAO code","schema":{"type":"string"}},{"name":"id","in":"query","required":false,"description":"Dataset id","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":3321,"iata":"LH","icao":"GEC","name":"Lufthansa Cargo","active":true,"country":"Germany","callsign":"LUFTHANSA CARGO"},"meta":{"timestamp":"2026-05-31T00:39:21.402Z","request_id":"7ae716ae-b93c-4afa-9034-70bcbb1f1f89"},"status":"ok","message":"Airline 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":["Airlines"],"summary":"Search airlines by name, country and status","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Airline name / alias / callsign","schema":{"type":"string"},"example":"lufthansa"},{"name":"country","in":"query","required":false,"description":"Filter by country","schema":{"type":"string"},"example":"Germany"},{"name":"active","in":"query","required":false,"description":"Filter by active status (true/false)","schema":{"type":"string"},"example":"true"},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"limit":20,"total":3,"offset":0,"filters":{"q":"lufthansa","active":true,"country":"germany"},"results":[{"id":3320,"iata":"LH","icao":"DLH","name":"Lufthansa","active":true,"country":"Germany","callsign":"LUFTHANSA"},{"id":3321,"iata":"LH","icao":"GEC","name":"Lufthansa Cargo","active":true,"country":"Germany","callsign":"LUFTHANSA CARGO"},{"id":3322,"iata":"CL","icao":"CLH","name":"Lufthansa CityLine","active":true,"country":"Germany","callsign":"HANSALINE"}]},"meta":{"timestamp":"2026-05-31T00:39:21.478Z","request_id":"342a7d4f-73dc-4eb5-8fd6-a31c3a0c3d71"},"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"}}}},"/v1/countries":{"get":{"operationId":"get_v1_countries","tags":["Countries"],"summary":"Countries with airline counts","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":276,"countries":[{"country":"United States","airlines":1099},{"country":"Mexico","airlines":440},{"country":"United Kingdom","airlines":414},{"country":"Canada","airlines":323},{"country":"Russia","airlines":238},{"country":"Spain","airlines":168},{"country":"Germany","airlines":135},{"country":"France","airlines":123},{"country":"Australia","airlines":93},{"country":"Italy","airlines":93},{"country":"South Africa","airlines":91},{"country":"Ukraine","airlines":90},{"country":"Nigeria","airlines":85},{"country":"Kazakhstan","airlines":79},{"country":"China","airlines":72},{"country":"Sweden","airlines":70},{"country":"Brazil","airlines":60},{"country":"Switzerland","airlines":60},{"country":"Thailand","airlines":52},{"country":"Netherlands","airlines":52},{"country":"Indonesia","airlines":50},{"country":"Austria","airlines":50},{"country":"Japan","airlines":49},{"country":"Egypt","airlines":49},{"country":"Sudan","airlines":49},{"country":"Portugal","airlines":45},{"country":"Colombia","airlines":44},{"country":"Chile","airlines":44},{"country":"Turkey","airlines":39},{"country":"Angola","airlines":37},{"country":"Mauritania","airlines":35},{"country":"Iran","airlines":34},{"country":"Kyrgyzstan","airlines":34},{"country":"Czech Republic","airlines":32},{"country":"Denmark","airlines":32},{"country":"United Arab Emirates","airlines":31},{"country":"Norway","airlines":31},{"country":"Dominican Republic","airlines":30},{"country":"Pakistan","airlines":29},{"country":"Greece","airlines":29},{"country":"Argentina","airlines":29},{"country":"India","airlines":29},{"country":"Ireland","airlines":28},{"country":"Bulgaria","airlines":28},{"country":"New Zealand","airlines":28},{"country":"Belgium","airlines":27},{"country":"Libya","airlines":26},{"country":"Sierra Leone","airlines":26},{"country":"Venezuela","airlines":26},{"country":"Peru","airlines":26},{"country":"Ecuador","airlines":26},{"country":"Kenya","airlines":24},{"country":"Uganda","airlines":24},{"country":"Zambia","airlines":23},{"country":"Israel","airlines":22},{"country":"Philippines","airlines":21},{"country":"Ghana","airlines":20},{"country":"Iceland","airlines":20},{"country":"Moldova","airlines":20},{"country":"Poland","airlines":20},{"country":"Democratic Republic of the Congo","airlines":19},{"country":"Finland","airlines":19},{"country":"Slovakia","airlines":19},{"country":"Cambodia","airlines":19},{"country":"Lithuania","airlines":19},{"country":"Hungary","airlines":18},{"country":"Georgia","airlines":18},{"country":"Romania","airlines":18},{"country":"Ivory Coast","airlines":17},{"country":"Armenia","airlines":17},{"country":"Haiti","airlines":17},{"country":"Lebanon","airlines":16},{"country":"Serbia","airlines":14},{"country":"Uruguay","airlines":14},{"country":"Bangladesh","airlines":14},{"country":"Malaysia","airlines":14},{"country":"Guinea","airlines":14},{"country":"Senegal","airlines":13},{"country":"Latvia","airlines":13},{"country":"Luxembourg","airlines":12},{"country":"Singapore","airlines":11},{"country":"Gabon","airlines":11},{"country":"Uzbekistan","airlines":11},{"country":"Namibia","airlines":11},{"country":"Nepal","airlines":11},{"country":"Equatorial Guinea","airlines":11},{"country":"Tanzania","airlines":10},{"country":"Croatia","airlines":10},{"country":"Barbados","airlines":10},{"country":"Bolivia","airlines":9},{"country":"Estonia","airlines":9},{"country":"Cyprus","airlines":9},{"country":"Bahrain","airlines":9},{"country":"Mali","airlines":9},{"country":"Belarus","airlines":9},{"country":"Bahamas","airlines":9},{"country":"Democratic Republic of Congo","airlines":9},{"country":"Taiwan","airlines":9},{"country":"Costa Rica","airlines":9},{"country":"Republic of Korea","airlines":8},{"country":"Morocco","airlines":8},{"country":"Afghanistan","airlines":8},{"country":"Vietnam","airlines":8},{"country":"Chad","airlines":8},{"country":"Guinea-Bissau","airlines":8},{"country":"Djibouti","airlines":8},{"country":"Macedonia","airlines":8},{"country":"Zimbabwe","airlines":8},{"country":"Mongolia","airlines":8},{"country":"Tunisia","airlines":8},{"country":"Azerbaijan","airlines":7},{"country":"Netherlands Antilles","airlines":7},{"country":"Sao Tome and Principe","airlines":7},{"country":"Maldives","airlines":7},{"country":"Burkina Faso","airlines":7},{"country":"Jordan","airlines":7},{"country":"Mozambique","airlines":7},{"country":"Cameroon","airlines":7},{"country":"Tajikistan","airlines":7},{"country":"Burma","airlines":7},{"country":"Gambia","airlines":6},{"country":"Slovenia","airlines":6},{"country":"Benin","airlines":6},{"country":"Swaziland","airlines":6},{"country":"Malta","airlines":6},{"country":"Aruba","airlines":6},{"country":"Panama","airlines":6},{"country":"Guatemala","airlines":6},{"country":"Algeria","airlines":6},{"country":"Honduras","airlines":6},{"country":"Sri Lanka","airlines":6},{"country":"Rwanda","airlines":6},{"country":"Suriname","airlines":6},{"country":"Oman","airlines":6},{"country":"Saudi Arabia","airlines":6},{"country":"South Korea","airlines":6},{"country":"Somali Republic","airlines":5},{"country":"Malawi","airlines":5},{"country":"Papua New Guinea","airlines":5},{"country":"El Salvador","airlines":5},{"country":"Ethiopia","airlines":5},{"country":"Fiji","airlines":5},{"country":"Republic of the Congo","airlines":5},{"country":"S","airlines":5},{"country":"Syrian Arab Republic","airlines":5},{"country":"Hong Kong SAR of China","airlines":5},{"country":"Central African Republic","airlines":5},{"country":"Cuba","airlines":5},{"country":"Netherland","airlines":5},{"country":"Togo","airlines":4},{"country":"Albania","airlines":4},{"country":"Bosnia and Herzegovina","airlines":4},{"country":"Jamaica","airlines":4},{"country":"Niger","airlines":4},{"country":"Nicaragua","airlines":4},{"country":"Turks and Caicos Islands","airlines":4},{"country":"Antigua and Barbuda","airlines":4},{"country":"Paraguay","airlines":4},{"country":"Kuwait","airlines":4},{"country":"Qatar","airlines":4},{"country":"Guyana","airlines":4},{"country":"Congo (Kinshasa)","airlines":4},{"country":"Liberia","airlines":3},{"country":"Hong Kong","airlines":3},{"country":"Turkmenistan","airlines":3},{"country":"Macao","airlines":3},{"country":"Russian Federation","airlines":3},{"country":"Belize","airlines":3},{"country":"Comoros","airlines":3},{"country":"Myanmar","airlines":3},{"country":"Mauritius","airlines":3},{"country":"Madagascar","airlines":3},{"country":"Burundi","airlines":3},{"country":"Cape Verde","airlines":3},{"country":"Solomon Islands","airlines":3},{"country":"Lao Peoples Democratic Republic","airlines":3},{"country":"Palau","airlines":3},{"country":"Tonga","airlines":3},{"country":"Yemen","airlines":3},{"country":"Kiribati","airlines":2},{"country":"Montenegro","airlines":2},{"country":"Faroe Islands","airlines":2},{"country":"Trinidad and Tobago","airlines":2},{"country":"Cayman Islands","airlines":2},{"country":"Eritrea","airlines":2},{"country":"Saint Lucia","airlines":2},{"country":"Iraq","airlines":2},{"country":"Nauru","airlines":2},{"country":"Cook Islands","airlines":2},{"country":"Saint Vincent and the Grenadines","airlines":2},{"country":"AEROCENTER","airlines":1},{"country":"Canadian Territories","airlines":1},{"country":"AEROCESAR","airlines":1},{"country":"AIRPORT HELICOPTER","airlines":1},{"country":"Reunion","airlines":1},{"country":"ALNACIONAL","airlines":1},{"country":"Seychelles","airlines":1},{"country":"ANTARES","airlines":1},{"country":"AVINOR","airlines":1},{"country":"ALCON","airlines":1},{"country":"ASTORIA","airlines":1},{"country":"COMPANY AS","airlines":1},{"country":"AIRPAC","airlines":1},{"country":"AIRFLIGHT","airlines":1},{"country":"ASA PESADA","airlines":1},{"country":"AIR PRINT","airlines":1},{"country":"APPALACHIAN","airlines":1},{"country":"ALASKA PACIFIC","airlines":1},{"country":"AEROPERLAS","airlines":1},{"country":"AEROPUMA","airlines":1},{"country":"ATCO","airlines":1},{"country":"AVIOQUINTANA","airlines":1},{"country":"S.A.","airlines":1},{"country":"ARMSTRONG","airlines":1},{"country":"AIREX","airlines":1},{"country":"ALASKA","airlines":1},{"country":"SCHEFF","airlines":1},{"country":"AEROSUN","airlines":1},{"country":"ALL STAR","airlines":1},{"country":"AIR CLASS","airlines":1},{"country":"ATLANTIS CANADA","airlines":1},{"country":"AUDI AIR","airlines":1},{"country":"AURORA AIR","airlines":1},{"country":"AUSA","airlines":1},{"country":"AVIANCA","airlines":1},{"country":"ALAMO","airlines":1},{"country":"AVEMEX","airlines":1},{"country":"Vanuatu","airlines":1},{"country":"AQUILINE","airlines":1},{"country":"ACTIVE AERO","airlines":1},{"country":"AEROVARADERO","airlines":1},{"country":"AIRNAT","airlines":1},{"country":"AIRWAVE","airlines":1},{"country":"AEROWEE","airlines":1},{"country":"AIR FREIGHTER","airlines":1},{"country":"RENTAXEL","airlines":1},{"country":"AIRMAN","airlines":1},{"country":"ATLANTIC NICARAGUA","airlines":1},{"country":"AZIMUT","airlines":1},{"country":"ARIZAIR","airlines":1},{"country":"Botswana","airlines":1},{"country":"French Polynesia","airlines":1},{"country":"Marshall Islands","airlines":1},{"country":"Air S","airlines":1},{"country":"French Guiana","airlines":1},{"country":"Democratic People's Republic of Korea","airlines":1},{"country":"AIR-MAUR","airlines":1},{"country":"ASUR","airlines":1},{"country":"DRAGON","airlines":1},{"country":"Bhutan","airlines":1},{"country":"UNIFORM OSCAR","airlines":1},{"country":"Russia]]","airlines":1},{"country":"Monaco","airlines":1},{"country":"ALDAWLYH AIR","airlines":1},{"country":"ODINN","airlines":1},{"country":"LAP","airlines":1},{"country":"Bermuda","airlines":1},{"country":"WATCHDOG","airlines":1},{"country":"Montserrat","airlines":1},{"country":"Samoa","airlines":1},{"country":"UNited Kingdom","airlines":1},{"country":"Brunei","airlines":1},{"country":"ACOM","airlines":1},{"country":"Boonville Stage Line","airlines":1},{"country":"SWISSBIRD","airlines":1},{"country":"AEROSOL","airlines":1},{"country":"Saint Kitts and Nevis","airlines":1},{"country":"VELES","airlines":1},{"country":"Cote d'Ivoire","airlines":1},{"country":"Guadeloupe","airlines":1},{"country":"Syria","airlines":1},{"country":"American Samoa","airlines":1},{"country":"British Virgin Islands","airlines":1},{"country":"Puerto Rico","airlines":1},{"country":"Congo (Brazzaville)","airlines":1},{"country":"South Sudan","airlines":1}],"total_airlines":6158},"meta":{"timestamp":"2026-05-31T00:39:21.531Z","request_id":"7ca30919-d968-4bf4-9b03-596ab801fe13"},"status":"ok","message":"Countries 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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Dataset totals & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"total":6158,"active":1252,"fields":["id","name","alias","iata","icao","callsign","country","active"],"source":"OpenFlights airlines database","countries":276,"with_iata":1533,"with_icao":5885},"meta":{"timestamp":"2026-05-31T00:39:21.614Z","request_id":"599f6b4a-4edb-4437-9b47-5cd2c07c377e"},"status":"ok","message":"Meta 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"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":35000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2300,"monthly_call_quota":175000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6000,"monthly_call_quota":700000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/airlines-api"}