Get airlines
curl -X GET "http://localhost:3000/v1/airlines?search=United" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Get airlines. Has over 800 records, only has commercial airlines.
Query parameters
The full (or a part of) name, IATA code, or ICAO code. Case insensitive.Examples: United, UA, UAL, or American
Response
Returns an array of airline objects.
Unique airline identifier
Airline nameExample: United Airlines
ICAO airline code (3 letters)Example: UAL
IATA airline code (2 letters)Example: UA
Airline logo image URLExample: https://cdn.aero.com/airlines/UA.png
Response example
[
{
"id": "airline_123",
"name": "United Airlines",
"icao": "UAL",
"iata": "UA",
"image": "https://cdn.aero.com/airlines/UA.png"
},
{
"id": "airline_456",
"name": "United Parcel Service",
"icao": "UPS",
"iata": "5X",
"image": "https://cdn.aero.com/airlines/5X.png"
}
]
Error responses
Internal server error{
"message": "Internal server error"
}
Search examples
Search by airline name
curl -X GET "http://localhost:3000/v1/airlines?search=Delta" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Search by IATA code
curl -X GET "http://localhost:3000/v1/airlines?search=AA" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Search by ICAO code
curl -X GET "http://localhost:3000/v1/airlines?search=AAL" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Search by partial name
curl -X GET "http://localhost:3000/v1/airlines?search=South" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Major airline codes
Here are some common airline codes for reference:
US airlines
European airlines
Asian airlines
Middle Eastern airlines
| Airline | IATA | ICAO |
|---|
| American Airlines | AA | AAL |
| Delta Air Lines | DL | DAL |
| United Airlines | UA | UAL |
| Southwest Airlines | WN | SWA |
| JetBlue Airways | B6 | JBU |
| Alaska Airlines | AS | ASA |
| Airline | IATA | ICAO |
|---|
| British Airways | BA | BAW |
| Lufthansa | LH | DLH |
| Air France | AF | AFR |
| KLM | KL | KLM |
| Ryanair | FR | RYR |
| EasyJet | U2 | EZY |
| Airline | IATA | ICAO |
|---|
| Emirates | EK | UAE |
| Singapore Airlines | SQ | SIA |
| Cathay Pacific | CX | CPA |
| ANA | NH | ANA |
| Japan Airlines | JL | JAL |
| Air India | AI | AIC |
| Airline | IATA | ICAO |
|---|
| Emirates | EK | UAE |
| Qatar Airways | QR | QTR |
| Etihad Airways | EY | ETD |
| Saudia | SV | SVA |
| Turkish Airlines | TK | THY |
Best practices
- Use the
search parameter to filter airlines and avoid retrieving all 800+ records
- Search is case-insensitive, so “united”, “UNITED”, and “United” will all return the same results
- You can search by partial names (e.g., “Air” will return all airlines with “Air” in the name)
- For the most accurate results, use IATA or ICAO codes when you know them
- The
image field may not be available for all airlines
Use cases
Airline autocomplete
Use this endpoint to power an autocomplete search for airline selection:
const searchAirlines = async (query) => {
const response = await fetch(
`http://localhost:3000/v1/airlines?search=${encodeURIComponent(query)}`,
{
headers: { 'Authorization': 'Bearer YOUR_JWT_TOKEN' }
}
);
return await response.json();
};
// User types "amer"
const results = await searchAirlines('amer');
// Returns: American Airlines, US Airways, etc.
const getAirlineByCode = async (iataCode) => {
const response = await fetch(
`http://localhost:3000/v1/airlines?search=${iataCode}`,
{
headers: { 'Authorization': 'Bearer YOUR_JWT_TOKEN' }
}
);
const airlines = await response.json();
return airlines.find(a => a.iata === iataCode);
};
const airline = await getAirlineByCode('UA');
console.log(airline.name); // "United Airlines"
console.log(airline.image); // Logo URL