AirHex 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.