{ "openapi": "3.1.0", "info": { "title": "Airlines API", "version": "1.0.0", "description": "4,650 airlines past and present with IATA and ICAO codes, callsigns, alliances and hub airports.\n\nEvery airline with a story, in one reference layer: 4,650 carriers past and present from Wikidata (CC0), 2,669 with IATA codes — the crosswalk travel tech actually needs. Resolve DL to Delta Air Lines with its ICAO code DAL, callsign DELTA, SkyTeam membership and real hub list (JFK, LAX, Sea-Tac...); resolve ICAO BAW to British Airways and Oneworld. Historic codes resolve too, active carriers ranked first — and defunct airlines carry their end year (Pan Am: 1991), which matters because IATA codes get reused. Search by name, country or alliance: Star Alliance lists its 68 active members led by Lufthansa, Turkish and United; Japan returns JAL and ANA on top. Each airline carries founding year, website, Wikipedia link and a notability rank. Completes our aviation family — pair with Airports (86k fields), Aircraft (ICAO types) and Aircraft Registrations (316k tail numbers) for full-stack aviation products. Built for booking and itinerary tools, flight trackers, loyalty apps and travel analytics. CC0 source data, self-hosted — no third-party calls at request time.", "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/airlines.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/airlines" }, "servers": [ { "url": "https://api-airlines.dataandapis.com" } ], "tags": [ { "name": "Transportation", "description": "Airlines API belongs to the Transportation category of the Data and APIs catalog." } ], "paths": { "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Airlines API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/airlines/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "attribution": "Data from Wikidata (CC0)", "count": 1, "sources": [ { "slug": "wikidata-airlines", "name": "Wikidata airlines (enwiki subset)", "publisher": "Wikidata contributors", "licence": "CC0 1.0 (public domain dedication)", "source_url": "https://www.wikidata.org/", "file_url": "https://query.wikidata.org/sparql", "cadence": "periodic full re-harvest", "record_count": 4650, "retrieved_at": "2026-09-06" } ] } } } }, "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/airlines/{qid}": { "get": { "operationId": "getAirline", "summary": "Get Airline", "description": "Get Airline endpoint of the Airlines API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/airlines/get-airline" }, "parameters": [ { "name": "qid", "in": "path", "required": true, "schema": { "type": "string" }, "example": "Q188920" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "airline": { "qid": "Q188920", "name": "Delta Air Lines", "iata": "DL", "icao": "DAL", "callsign": "DELTA", "country": "United States", "alliance": "SkyTeam", "hubs": [ "John F. Kennedy International Airport", "Los Angeles International Airport", "Seattle–Tacoma International Airport", "Hartsfield–Jackson Atlanta International Airport", "LaGuardia Airport" ], "founded_year": 1925, "defunct_year": null, "active": true, "website": "https://zh.delta.com/", "wikipedia": "https://en.wikipedia.org/wiki/Delta_Air_Lines", "notability_rank": 74 } } } } }, "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/airlines/iata/{code}": { "get": { "operationId": "lookupByIataCode", "summary": "Lookup By IATA Code", "description": "Lookup By IATA Code endpoint of the Airlines API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/airlines/lookup-by-iata-code" }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "example": "DL" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "iata": "DL", "count": 3, "results": [ { "qid": "Q188920", "name": "Delta Air Lines", "iata": "DL", "icao": "DAL", "callsign": "DELTA", "country": "United States", "alliance": "SkyTeam", "hubs": [ "John F. Kennedy International Airport", "Los Angeles International Airport", "Seattle–Tacoma International Airport", "Hartsfield–Jackson Atlanta International Airport", "LaGuardia Airport" ], "founded_year": 1925, "defunct_year": null, "active": true, "website": "https://zh.delta.com/", "wikipedia": "https://en.wikipedia.org/wiki/Delta_Air_Lines", "notability_rank": 74 }, { "qid": "Q667992", "name": "Song", "iata": "DL", "icao": "DAL", "callsign": "DELTA", "country": "United States", "alliance": "SkyTeam", "hubs": [ "Orlando International Airport" ], "founded_year": 2003, "defunct_year": 2006, "active": false, "website": "http://www.flysong.com/", "wikipedia": "https://en.wikipedia.org/wiki/Song_(airline)", "notability_rank": 10 }, { "qid": "Q5254629", "name": "Delta Express", "iata": "DL", "icao": "DAL", "callsign": "DELTA", "country": "United States", "alliance": "SkyTeam", "hubs": [ "Orlando International Airport" ], "founded_year": 1996, "defunct_year": 2003, "active": false, "website": "http://www.flydlx.com/", "wikipedia": "https://en.wikipedia.org/wiki/Delta_Express", "notability_rank": 5 } ] } } } }, "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/airlines/icao/{code}": { "get": { "operationId": "lookupByIcaoCode", "summary": "Lookup By ICAO Code", "description": "Lookup By ICAO Code endpoint of the Airlines API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/airlines/lookup-by-icao-code" }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "example": "BAW" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "icao": "BAW", "count": 2, "results": [ { "qid": "Q8766", "name": "British Airways", "iata": "BA", "icao": "BAW", "callsign": "SPEEDBIRD", "country": "United Kingdom", "alliance": "Oneworld", "hubs": [ "London Heathrow Airport", "London Gatwick Airport" ], "founded_year": 1919, "defunct_year": null, "active": true, "website": "https://britishairways.com/", "wikipedia": "https://en.wikipedia.org/wiki/British_Airways", "notability_rank": 83 }, { "qid": "Q4969503", "name": "British Asia Airways", "iata": "BR", "icao": "BAW", "callsign": "SPEEDBIRD", "country": "United Kingdom", "alliance": null, "hubs": [ "London Heathrow Airport", "Taoyuan International Airport" ], "founded_year": 1993, "defunct_year": 2001, "active": false, "website": null, "wikipedia": "https://en.wikipedia.org/wiki/British_Asia_Airways", "notability_rank": 6 } ] } } } }, "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/airlines": { "get": { "operationId": "searchAirlines", "summary": "Search Airlines", "description": "Search Airlines endpoint of the Airlines API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/airlines/search-airlines" }, "parameters": [ { "name": "active", "in": "query", "required": false, "schema": { "type": "string" }, "example": "true" }, { "name": "alliance", "in": "query", "required": false, "schema": { "type": "string" }, "example": "Star Alliance" }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "20" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "example": "1" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "lufthansa" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "total": 4, "page": 1, "limit": 20, "count": 4, "results": [ { "qid": "Q9325", "name": "Lufthansa", "iata": "LH", "icao": "DLH", "callsign": "LUFTHANSA", "country": "Germany", "alliance": "Star Alliance", "hubs": [ "Frankfurt Airport", "Munich Airport" ], "founded_year": 1926, "defunct_year": null, "active": true, "website": "https://lufthansa.com", "wikipedia": "https://en.wikipedia.org/wiki/Lufthansa", "notability_rank": 101 }, { "qid": "Q162189", "name": "Lufthansa CityLine", "iata": "CL", "icao": "CLH", "callsign": "HANSALINE", "country": "Germany", "alliance": "Star Alliance", "hubs": [ "Frankfurt Airport", "Munich Airport" ], "founded_year": 1958, "defunct_year": null, "active": true, "website": "https://www.lufthansacityline.com/", "wikipedia": "https://en.wikipedia.org/wiki/Lufthansa_CityLine", "notability_rank": 27 }, { "qid": "Q170159", "name": "Lufthansa Regional", "iata": "LH", "icao": "DLH", "callsign": "LUFTHANSA", "country": "Germany", "alliance": "Star Alliance", "hubs": [ "Frankfurt Airport" ], "founded_year": 2004, "defunct_year": null, "active": true, "website": "https://www.lufthansagroup.com/de/unternehmen/allianzen/lufthansa-regional.html", "wikipedia": "https://en.wikipedia.org/wiki/Lufthansa_Regional", "notability_rank": 25 }, { "qid": "Q117191656", "name": "Lufthansa City Airlines", "iata": "VL", "icao": "LHX", "callsign": null, "country": "Germany", "alliance": "Star Alliance", "hubs": [], "founded_year": 2023, "defunct_year": null, "active": true, "website": "https://www.lufthansa-city.com/", "wikipedia": "https://en.wikipedia.org/wiki/Lufthansa_City_Airlines", "notability_rank": 10 } ] } } } }, "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 1 token per call." } } }, "security": [ { "ApiKey": [] } ] }