AirHex airlines endpoint API v3.3 reference

NOTE: This is the endpoint to fetch airlines information. Full list of endpoints available here: https://airhex.com/api/


Endpoint description
This endpoint retrieves specific airline details or dumps the entire database with output in JSON, XML or CSV file

HTTP Request
GET https://content.airhex.com/api/v3.3/airlines

Request Example
https://content.airhex.com/api/v3.3/airlines?apikey=WcPi7fGFMTihmwdNxkn4XYwZtdhKuykg&iata=EK

*Note: At least one of these parameters is required: iata/icao/name/dump

Request Parameters

Parameter Required Value Type Default Description
apikey Required Any String none API key received from us. Contact us if you don't have one yet.
iata Required* (at least one parameter with asterisk required) 00-ZZ String none IATA code for a specific airline query
icao Required* (at least one parameter with asterisk required) 000-ZZZ String none ICAO code for a specific airline query
name Required* (at least one parameter with asterisk required) Any String none Name for a specific airline or multiple airlines query. Search will be performed for airlines contains name provided with this parameter.
dump Required* (at least one parameter with asterisk required) 0 or 1 Integer 0 Set as "1" to get all entries from the database. Other required parameters will be ignored
language Optional en, ru String en Response language. Currently supports English and Russian languages
response_type Optional JSON or XML or CSV String JSON Types of responses: JSON, XML or CSV (CSV downloads as a file)
onlyscheduled Optional 0 or 1 Integer 1 Query only scheduled airlines. Set as "0" if you also want to get results for cargo, jet, charter airlines and other instances with IATA codes
logo_rectangle_width Optional 1 to 1400 Integer 700 Get links to rectangular logos with specified width
logo_rectangle_height Optional 1 to 400 Integer 200 Get links to rectangular logos with specified height
logo_square_width Optional 1 to 400 Integer 200 Get links to square logos with specified width
logo_square_height Optional 1 to 400 Integer 200 Get links to square logos with specified height

Response Fields

Field Example Description
updated 2017-12-06 12:13:10 Record last updated date
iata EK Airline's official IATA code
icao UAE Airline's official ICAO code
marketing_name Emirates Airline's marketing name
full_name Emirates Airline's official name
status 1 '1' for active airlines and '0' for non-active airlines
type SCHEDULED Type of airline/record - Scheduled, Passenger/Charter, Jet/Charter, Railway/Bus/Ferry, Helicopter/Charter, Tour, Cargo, ACMI, Others
type_code 1 Code of airline/record type. 1 - Scheduled, 2 - Passenger/Charter, 3 - Railway/Bus/Ferry, 4 - Helicopter/Charter, 5 - Jet/Charter, 6 - Tour, 7 - ACMI, 8 - Cargo, 9 - Others
lowcost 0 Shows if airline is LCC. Set to '1' for low cost carriers
country_name United Arab Emirates Country of airline's HQ, full country name
country_code_alpha_2 AE Country of airline's HQ, ISO 3166-1 Alpha-2 country code
country_code_alpha_3 ARE Country of airline's HQ, ISO 3166-1 Alpha-3 country code
founded 1985 Year of the airline's foundation
ios_app https://itunes.apple.com/us/app/the-emirates-app/id935307149?mt=8 Link to the airline's iOS app
android_app https://play.google.com/store/apps/details?id=com.emirates.ek.android&hl=en Link to the airline's Android app
facebook https://www.facebook.com/Emirates Link to the airline's Facebook page
website https://www.emirates.com Link to the airline's website. Starts with http or https
web_checkin_url https://www.emirates.com/english/manage-booking/online-check-in.aspx Direct link to the airline's web check-in
mobile_checkin_url https://mobile1.emirates.com/english/CKIN/OLCI/flightInfo.xhtml Direct link to the airline's mobile check-in
logo_rectangle https://airhex.com/content/logos/airlines_EK_700_200_r.png?md5apikey=762a2a2956a8c37a27de16d8f8d79916 Link to the airline's rectangular logo (3.5:1 side ratio) with dimensions specified in request (or default size if not specified). It already includes the secret md5apikey hash for your API key. Use only this final link for public/hotlinking
logo_square https://airhex.com/content/logos/airlines_EK_200_200_s.png?md5apikey=cf68b87e623c481617f4f9e7078ec271 Link to the airline's square logo (1:1 side ratio) with dimensions specified in request (or default size if not specified). It already includes the secret md5apikey hash for your API key. Use only this final link for public/hotlinking


Response Example (JSON)
[
    {
        "updated": "2017-12-06 12:13:10",
        "iata": "EK",
        "icao": "UAE",
        "marketing_name": "Emirates",
        "full_name": "Emirates",
        "status": "1",
        "type": "SCHEDULED",
        "type_code": "1",
        "lowcost": "0",
        "country_name": "United Arab Emirates",
        "country_code_alpha_2": "AE",
        "country_code_alpha_3": "ARE",
        "founded": "1985",
        "ios_app": "https:\/\/itunes.apple.com\/us\/app\/the-emirates-app\/id935307149?mt=8",
        "android_app": "https:\/\/play.google.com\/store\/apps\/details?id=com.emirates.ek.android&hl=en",
        "facebook": "https:\/\/www.facebook.com\/Emirates",
        "website": "https:\/\/www.emirates.com",
        "web_checkin_url": "https:\/\/www.emirates.com\/english\/manage-booking\/online-check-in.aspx",
        "mobile_checkin_url": "https:\/\/mobile1.emirates.com\/english\/CKIN\/OLCI\/flightInfo.xhtml",
        "logo_rectangle": "https:\/\/airhex.com\/content\/logos\/airlines_EK_700_200_r.png?md5apikey=762a2a2956a8c37a27de16d8f8d79916",
        "logo_square": "https:\/\/airhex.com\/content\/logos\/airlines_EK_200_200_s.png?md5apikey=cf68b87e623c481617f4f9e7078ec271"
    }
]


Response Example (XML)
<?xml version="1.0" encoding="UTF-8"?>
<airlines>
 <airline>
  <updated>2017-12-06 12:13:10</updated>
  <iata>EK</iata>
  <icao>UAE</icao>
  <marketing_name>Emirates</marketing_name>
  <full_name>Emirates</full_name>
  <status>1</status>
  <type>SCHEDULED</type>
  <type_code>1</type_code>
  <lowcost>0</lowcost>
  <country_name>United Arab Emirates</country_name>
  <country_code_alpha_2>AE</country_code_alpha_2>
  <country_code_alpha_3>ARE</country_code_alpha_3>
  <founded>1985</founded>
  <ios_app>https://itunes.apple.com/us/app/the-emirates-app/id935307149?mt=8</ios_app>
  <android_app>https://play.google.com/store/apps/details?id=com.emirates.ek.android&hl=en</android_app>
  <facebook>https://www.facebook.com/Emirates</facebook>
  <website>https://www.emirates.com</website>
  <web_checkin_url>https://www.emirates.com/english/manage-booking/online-check-in.aspx</web_checkin_url>
  <mobile_checkin_url>https://mobile1.emirates.com/english/CKIN/OLCI/flightInfo.xhtml</mobile_checkin_url>
  <logo_rectangle>https://airhex.com/content/logos/airlines_EK_700_200_r.png?md5apikey=762a2a2956a8c37a27de16d8f8d79916</logo_rectangle>
  <logo_square>https://airhex.com/content/logos/airlines_EK_200_200_s.png?md5apikey=cf68b87e623c481617f4f9e7078ec271</logo_square>
 </airline>
</airlines>


Still have some questions?
Just write us and we would be happy to help you with our API.