Airline Database and Codes API
NOTE: This is the endpoint to fetch airlines information. View all available API endpoints.
Don't have an API key for airline database API but want a try?
Get StartedAPI Endpoint Description
This endpoint provides access to detailed airline information, including the ability to retrieve specific airline records or export the entire airline database in JSON, XML, or CSV formats
Endpoint Address
GET https://content.airhex.com/api/v3.7.7/airlines
Example Request
https://content.airhex.com/api/v3.7.7/airlines?apikey=WcPi7fGFMTihmwdNxkn4XYwZtdhKuykg&iata=WN
*Note: At least one query parameter (iata, icao, name, or dump) is required.
Request Parameters| Parameter | Required | Value | Type | Default | Description |
|---|---|---|---|---|---|
| apikey | Required | Any | String | none | Your assigned API key. Request a key if needed |
| iata | Conditional | 00-ZZ | String | none | Two-letter IATA airline code |
| icao | Conditional | 000-ZZZ | String | none | Three-letter ICAO airline code |
| name | Conditional | Any | String | none | Airline name or substring for partial matching |
| dump | Conditional | 0 or 1 | Integer | 0 | Set to 1 to export the complete database. Overrides other query parameters. |
| response_type | Optional | JSON or XML or CSV | String | JSON | Response format: JSON, XML, or CSV (CSV triggers file download) |
| onlyscheduled | Optional | 0 or 1 | Integer | 1 | Filter to include only scheduled airlines (1) or all airline types including cargo, private jets, etc (0) |
| logo_rectangle_width | Optional | 1 to 1400 | Integer | 700 | Width of rectangular logo images |
| logo_rectangle_height | Optional | 1 to 400 | Integer | 200 | Height of rectangular logo images |
| logo_square_width | Optional | 1 to 400 | Integer | 200 | Width of square and tail logo images |
| logo_square_height | Optional | 1 to 400 | Integer | 200 | Height of square and tail logo images |
Response Fields
| Field | Example | Description |
|---|---|---|
| updated | 2023-04-07 03:29:34 | Date and time the record was last updated |
| iata | WN | Airline's IATA code |
| icao | SWA | Airline's ICAO code |
| parent_icao | ICAO code of parent airline (if applicable) | |
| marketing_name | Southwest Airlines | Commonly used airline name for marketing purposes |
| full_name | Southwest Airlines Co. | Airline's registered legal name |
| status | 1 | Airline operational status: 1 = Active, 0 = Defunct, 2 = Start-up, pending to commence operations |
| type | SCHEDULED | Airline category: Scheduled, Passenger/Charter, Cargo, ACMI, etc. |
| type_code | 1 | Numeric code indicating airline type. 1 - Scheduled, 2 - Passenger/Charter, 3 - Railway/Bus/Ferry, 4 - Helicopter/Charter, 5 - Jet/Charter, 6 - Tour, 7 - ACMI, 8 - Cargo, 9 - Others |
| alliance | Airline alliance membership (if applicable) | |
| ffp_name | Rapid Rewards | Name of the airline's frequent flyer program |
| lowcost | 1 | Indicates a low-cost carrier (1 if LCC, else 0) |
| country_name | United States | Country of the airline’s headquarters |
| country_code_alpha_2 | US | ISO 3166-1 Alpha-2 country code of airline HQ |
| country_code_alpha_3 | USA | ISO 3166-1 Alpha-3 country code of airline HQ |
| founded | 1967 | Year the airline was established |
| website | https://www.southwest.com | Official airline website URL |
| web_checkin_url | https://www.southwest.com/air/check-in/index.html | URL for web-based passenger check-in |
| mobile_checkin_url | https://mobile.southwest.com/check-in | URL for mobile passenger check-in |
| baggage_url | https://www.southwest.com/html/customer-service/baggage/index.html | URL to airline’s baggage allowance policy |
| colorscheme new! | [{"color":[220,28,36],"percent":46,"hex":"#DC1C24","dark":1},{"color":[44,66,153],"percent":22,"hex":"#2C4299","dark":1},{"color":[203,203,203],"percent":21,"hex":"#CBCBCB","dark":0},{"color":[251,172,28],"percent":9,"hex":"#FBAC1C","dark":0},{"color":[43,60,132],"percent":2,"hex":"#2B3C84","dark":1}] | Array detailing the airline's primary colors used in branding (RGB values, percentages, hex codes, darkness indicators) |
| logo_rectangle | https://content.airhex.com/content/logos/airlines_WN_700_200_r.png?md5apikey=e742a162ae44192913f94cdc74895b32 | Direct URL to the rectangular airline logo image with specified dimensions and secured API hash |
| logo_square | https://content.airhex.com/content/logos/airlines_WN_200_200_s.png?md5apikey=cedfc6e88eba47799d33a91523f2a1b9 | Direct URL to the square airline logo image with specified dimensions and secured API hash |
| logo_tail | https://content.airhex.com/content/logos/airlines_WN_200_200_t.png?md5apikey=8b855307bc1129996236f1fc65290f27 | Direct URL to the airline’s tail logo image with specified dimensions and secured API hash |
Example Response (JSON)
[
{
"updated": "2023-04-07 03:29:34",
"iata": "WN",
"icao": "SWA",
"parent_icao": null,
"marketing_name": "Southwest Airlines",
"full_name": "Southwest Airlines Co.",
"status": "1",
"type": "SCHEDULED",
"type_code": "1",
"alliance": null,
"ffp_name": "Rapid Rewards",
"lowcost": "1",
"country_name": "United States",
"country_code_alpha_2": "US",
"country_code_alpha_3": "USA",
"founded": "1967",
"baggage_url": "https:\/\/www.southwest.com\/html\/customer-service\/baggage\/index.html",
"colorscheme": [
{
"color": [
220,
28,
36
],
"percent": 46,
"hex": "#DC1C24",
"dark": 1
},
{
"color": [
44,
66,
153
],
"percent": 22,
"hex": "#2C4299",
"dark": 1
},
{
"color": [
203,
203,
203
],
"percent": 21,
"hex": "#CBCBCB",
"dark": 0
},
{
"color": [
251,
172,
28
],
"percent": 9,
"hex": "#FBAC1C",
"dark": 0
},
{
"color": [
43,
60,
132
],
"percent": 2,
"hex": "#2B3C84",
"dark": 1
}
],
"website": "https:\/\/www.southwest.com",
"web_checkin_url": "https:\/\/www.southwest.com\/air\/check-in\/index.html",
"mobile_checkin_url": "https:\/\/mobile.southwest.com\/check-in",
"logo_rectangle": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_700_200_r.png?md5apikey=e742a162ae44192913f94cdc74895b32",
"logo_square": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_s.png?md5apikey=cedfc6e88eba47799d33a91523f2a1b9",
"logo_tail": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_t.png?md5apikey=8b855307bc1129996236f1fc65290f27",
"logo_tail_flipped": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_f.png?md5apikey=33d73ff0ba4bae6f807732bcec857daa"
}
]Example Response (XML)
<?xml version="1.0" encoding="UTF-8"?>
<airlines>
<airline>
<updated>2023-04-07 03:29:34</updated>
<iata>WN</iata>
<icao>SWA</icao>
<parent_icao></parent_icao>
<marketing_name>Southwest Airlines</marketing_name>
<full_name>Southwest Airlines Co.</full_name>
<status>1</status>
<type>SCHEDULED</type>
<type_code>1</type_code>
<alliance></alliance>
<ffp_name>Rapid Rewards</ffp_name>
<lowcost>1</lowcost>
<country_name>United States</country_name>
<country_code_alpha_2>US</country_code_alpha_2>
<country_code_alpha_3>USA</country_code_alpha_3>
<founded>1967</founded>
<baggage_url>https://www.southwest.com/html/customer-service/baggage/index.html</baggage_url>
<website>https://www.southwest.com</website>
<web_checkin_url>https://www.southwest.com/air/check-in/index.html</web_checkin_url>
<mobile_checkin_url>https://mobile.southwest.com/check-in</mobile_checkin_url>
<logo_rectangle>https://content.airhex.com/content/logos/airlines_WN_700_200_r.png?md5apikey=e742a162ae44192913f94cdc74895b32</logo_rectangle>
<logo_square>https://content.airhex.com/content/logos/airlines_WN_200_200_s.png?md5apikey=cedfc6e88eba47799d33a91523f2a1b9</logo_square>
<logo_tail>https://content.airhex.com/content/logos/airlines_WN_200_200_t.png?md5apikey=8b855307bc1129996236f1fc65290f27</logo_tail>
<logo_tail_flipped>https://content.airhex.com/content/logos/airlines_WN_200_200_f.png?md5apikey=33d73ff0ba4bae6f807732bcec857daa</logo_tail_flipped>
</airline>
</airlines>