AirHex IATA and ICAO airports endpoint API v3.3 reference

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

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

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

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

*Note: At least one of these parameters is required: iata/icao/city_code/country_code/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)	AAA-ZZZ	String	none	3 char code for a specific airport (matched with IATA airport code)
icao	Required* (at least one parameter with asterisk required)	AAAA-ZZZZ	String	none	4 char code for a specific airport (matched with ICAO airport code)
city_code	Required* (at least one parameter with asterisk required)	AAA-ZZZ	String	none	3 char city code (matched with IATA city code)
country_code	Required* (at least one parameter with asterisk required)	AA-ZZ	String	none	2 char country code (ISO 3166-1 Alpha-2)
name	Required* (at least one parameter with asterisk required)	Any	String	none	Name of a specific airport or multiple airports. Search will be performed for airports 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)

Response Fields

Field	Example	Description
iata	LHR	3 char airport code (matched with IATA airport code)
icao	EGLL	4 char airport code (matched with ICAO airport code)
name	London Heathrow Airport	Airport name
city_code	LON	3 char code of the city where airport is located (matched with IATA city code)
country_code	GB	ISO 3166-1 Alpha-2, 2 char country code of a specific airport
timezone	Europe/London	Timezone of the airport
utc	1	Airport UTC time difference
latitude	51.469603	Latitude of a airport location
longitude	-0.453566	Longitude of a airport location
active	1	1 for active airports and 0 for non-active airports
popularity	53	Internal metric to sort airports by popularity. Based on number of flights to the airport.

Response Example (JSON)

[
    {
        "iata": "LHR",
        "icao": "EGLL",
        "name": "London Heathrow Airport",
        "city_code": "LON",
        "country_code": "GB",
        "timezone": "Europe\/London",
        "utc": "1",
        "latitude": "51.469603",
        "longitude": "-0.453566",
        "active": "1",
        "popularity": "53"
    }
]

Response Example (XML)

<?xml version="1.0" encoding="UTF-8"?>
<airports>
 <airport>
  <iata>LHR</iata>
  <icao>EGLL</icao>
  <name>London Heathrow Airport</name>
  <city_code>LON</city_code>
  <country_code>GB</country_code>
  <timezone>Europe/London</timezone>
  <utc>1</utc>
  <latitude>51.469603</latitude>
  <longitude>-0.453566</longitude>
  <active>1</active>
  <popularity>53</popularity>
 </airport>
</airports>

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