airportdata.aero | airport and handling details for passenger and cargo airlines

Search Resources

These resources can be used to find which airports are in the database.
The resources that return lists of regions and countries could be used to populate look-up lists on a user interface.
For details of field properties, please click here.

/region
Returns list of valid regions
When entering the web address, please replace "XXXXXXXXXXXX" with your API key.
https://api.airportdata.com/regions?apikey=XXXXXXXXXXXX
https://api.airportdata.com/regions?apikey=XXXXXXXXXXXX&format=xml
Method
GET – retrieves a list of valid regions sorted by region name. A region being a grouping of countries e.g. Europe.
Response
JSON
{    
  "regions": [  

{
    "region_id": 6,
    "region_name": "Africa"
  },  

{
    "region_id": 2,
    "region_name": "Central America and the Caribbean"
  },  
  ]  
}    
XML
<regions>    
  <region>  
    <region_id>6</region_id>
    <region_name>Africa</region_name>
  </region>  
  <region>  
    <region_id>2</region_id>
    <region_name>Central America and the Caribbean</region_name>
  </region>  
</regions>    
/countries
Returns list of valid countries
When entering the web address, please replace "XXXXXXXXXXXX" with your API key.
https://api.airportdata.com/countries?apikey=XXXXXXXXXXXX&region_id=4
https://api.airportdata.com/countries?apikey=XXXXXXXXXXXX&region_id=4&format=xml
Method
GET – retrieves a list of valid countries sorted by name. Note that the Airportdata database has more countries than ISO 3166. For example, Northern Cyprus and Kosovo.
Query Parameters
Parameter Value Description
region_id Integer Filter countries by region e.g. /countries?region_id=4
Response
JSON
{    
  "countries": [  

{
    "country_id": 57,
    "country_name": "CYPRUS"
    "iso_country_name": "CYPRUS"
    "iso_code_2": "CY"
    "iso_code_3": "CYP"
    "region_id": 4
    "region_name": "Europe"
  },  

{
    "country_id": 244,
    "country_name": "CYPRUS (NORTHERN)"
    "iso_country_name": "CYPRUS"
    "iso_code_2": "CY"
    "iso_code_3": "CYP"
    "region_id": 4
    "region_name": "Europe"
  }  
  ]  
}    
XML
<countries>    
  <country>  
    <country_id>57</country_id>
    <country_name>CYPRUS</country_name>
    <iso_country_name>CYPRUS</iso_country_name>
    <iso_code_2>CY</iso_code_2>
    <iso_code_3>CYP</iso_code_3>
    <region_id>4</region_id>
    <region_name>Europe</region_name>
  </country>  
  <country>  
    <country_id>244</country_id>
    <country_name>CYPRUS (NORTHERN)</country_name>
    <iso_country_name>CYPRUS</iso_country_name>
    <iso_code_2>CY</iso_code_2>
    <iso_code_3>CYP</iso_code_3>
    <region_id>4</region_id>
    <region_name>Europe</region_name>
  </country>  
</countries>    
/iso_countries
Returns list of valid ISO 3166 countries
When entering the web address, please replace "XXXXXXXXXXXX" with your API key.
https://api.airportdata.com/iso_countries?apikey=XXXXXXXXXXXX&region_id=4
https://api.airportdata.com/iso_countries?apikey=XXXXXXXXXXXX&region_id=4&format=xml
Method
GET – retrieves a list of valid ISO countries sorted by name. Note that Northern Cyprus and Kosovo are not recognised by ISO.
Query Parameters
Parameter Value Description
region_id Integer (optional) Filter countries by region e.g. /iso_countries?region_id=4
Response
JSON
{    
  "countries": [  

{
    "iso_country_id": 55,
    "iso_country_name": "CROATIA"
    "iso_code_2": "HR"
    "iso_code_3": "HRV"
    "region_id": 4
    "region_name": "Europe"
  },  

{
    "iso_country_id": 57,
    "iso_country_name": "CYPRUS"
    "iso_code_2": "CY"
    "iso_code_3": "CYP"
    "region_id": 4
    "region_name": "Europe"
  },  

{
    "iso_country_id": 58,
    "iso_country_name": "CZECH REPUBLIC"
    "iso_code_2": "CZ"
    "iso_code_3": "CZE"
    "region_id": 4
    "region_name": "Europe"
  }  
  ]  
}    
XML
<countries>    
  <country>  
    <iso_country_id>55</iso_country_id>
    <iso_country_name>CROATIA</iso_country_name>
    <iso_code_2>HR</iso_code_2>
    <iso_code_3>HRV</iso_code_3>
    <region_id>4</region_id>
    <region_name>Europe</region_name>
  </country>  
  <country>  
    <iso_country_id>57</country_id>
    <iso_country_name>CYPRUS</iso_country_name>
    <iso_code_2>CY</iso_code_2>
    <iso_code_3>CYP</iso_code_3>
    <region_id>4</region_id>
    <region_name>Europe</region_name>
  </country>  
  <country>  
    <iso_country_id>58</country_id>
    <iso_country_name>CZECH REPUBLIC</iso_country_name>
    <iso_code_2>CZ</iso_code_2>
    <iso_code_3>CZE</iso_code_3>
    <region_id>4</region_id>
    <region_name>Europe</region_name>
  </country>  
</countries>    
/countries/{country_id}/subdivisions
Returns list of subdivisions, i.e. counties/states, for a country
When entering the web address, please replace "XXXXXXXXXXXX" with your API key.
https://api.airportdata.com/countries/230/subdivisions?apikey=XXXXXXXXXXXX
https://api.airportdata.com/countries/230/subdivisions?apikey=XXXXXXXXXXXX&format=xml
Method
GET – retrieves a list of valid subdivisions and subdivision abbreviations, sorted by name.
Query Parameters
Parameter Value Description
country_id Integer (mandatory) Integer country ID
Response
JSON
{    
  "subdivisions": [  

{
    "subdivision_id": 532,
    "subdivision_name": "Alabama"
    "subdivision_abbreviation": "AL"
  },  

{
    "subdivision_id": 531,
    "subdivision_name": "Alaska"
    "subdivision_abbreviation": "AK"
  },  
    "subdivision_id": 534,
    "subdivision_name": "Arizona"
    "subdivision_abbreviation": "AZ"
  }  
  ]  
}    
XML
<subdivisions>    
  <subdivision>  
    <subdivision_id>532</subdivision_id>
    <subdivision_name>Alabama</subdivision_name>
    <subdivision_abbreviation>AL</subdivision_abbreviation>
  </subdivision>  
  <subdivision>  
    <subdivision_id>531</subdivision_id>
    <subdivision_name>Alaska</subdivision_name>
    <subdivision_abbreviation>AK</subdivision_abbreviation>
  </subdivision>  
  <subdivision>  
    <subdivision_id>534</subdivision_id>
    <subdivision_name>Arizona</subdivision_name>
    <subdivision_abbreviation>AZ</subdivision_abbreviation>
  </subdivision>  
</subdivisions>    
/iso_countries/{iso_country_id}/subdivisions
Returns list of subdivisions, i.e. counties/states, for an ISO 3166 country
When entering the web address, please replace "XXXXXXXXXXXX" with your API key.
https://api.airportdata.com/iso_countries/233/subdivisions?apikey=XXXXXXXXXXXX
https://api.airportdata.com/iso_countries/233/subdivisions?apikey=XXXXXXXXXXXX&format=xml
Method
GET – retrieves a list of valid subdivisions and subdivision abbreviations, sorted by name.
Query Parameters
Parameter Value Description
iso_country_id Integer (mandatory) Integer ISO country ID
Response
JSON
{    
  "subdivisions": [  

{
    "subdivision_id": 532,
    "subdivision_name": "Alabama"
    "subdivision_abbreviation": "AL"
  },  

{
    "subdivision_id": 531,
    "subdivision_name": "Alaska"
    "subdivision_abbreviation": "AK"
  },  
    "subdivision_id": 534,
    "subdivision_name": "Arizona"
    "subdivision_abbreviation": "AZ"
  }  
  ]  
}    
XML
<subdivisions>    
  <subdivision>  
    <subdivision_id>532</subdivision_id>
    <subdivision_name>Alabama</subdivision_name>
    <subdivision_abbreviation>AL</subdivision_abbreviation>
  </subdivision>  
  <subdivision>  
    <subdivision_id>531</subdivision_id>
    <subdivision_name>Alaska</subdivision_name>
    <subdivision_abbreviation>AK</subdivision_abbreviation>
  </subdivision>  
  <subdivision>  
    <subdivision_id>534</subdivision_id>
    <subdivision_name>Arizona</subdivision_name>
    <subdivision_abbreviation>AZ</subdivision_abbreviation>
  </subdivision>  
</subdivisions>    
/airports
Find airports matching various criteria
When entering the web address, please replace "XXXXXXXXXXXX" with your API key.
https://api.airportdata.com/airports?apikey=XXXXXXXXXXXX&country_id=227&min_runway_len=10000
https://api.airportdata.com/airports?apikey=XXXXXXXXXXXX&country_id=227&min_runway_len=10000&format=xml
Method
GET – retrieves a list of airports sorted by ICAO but optionally by name. Note that you must pass either the country_id or the iso_country_id as a parameter.
Query Parameters
Parameter Value Description
country_id Integer (optional if iso_country_id is set) Filter by country - takes precedence if iso_country_code is also set
iso_country_id Integer (optional if country_id is set) Filter by ISO country
subdivision_id Integer (optional) Filter by state/county
min_runway_len Integer (optional) Filter by runway length (in feet)
entry_only Integer (optional) One of 0 or 1. 1=restrict to airports of entry
sort_by_name Integer (optional) One of 0 or 1. 1=sort by name. Default behaviour is to sort by ICAO code.
Response
JSON
{    
  "airports": [  

{
    "airport_id": 3415,
    "icao": "OMAA",
    "iata": "AUH",
    "faa": null,
    "airport_name": "Abu Dhabi International"
    "city": "Abu Dhabi"
    "country_name": "UNITED ARAB EMIRATES"
    "iso_country_name": "UNITED ARAB EMIRATES"
    "airport_of_entry": "Yes"
    "last_edited": "24/2/2014"
  },  

{
    "airport_id": 3416,
    "icao": "OMAD",
    "iata": "AZI",
    "faa": null,
    "airport_name": "Al Bateen Executive International"
    "city": "Abu Dhabi"
    "country_name": "UNITED ARAB EMIRATES"
    "iso_country_name": "UNITED ARAB EMIRATES"
    "airport_of_entry": "Yes"
    "last_edited": "24/2/2014"
  }  
  ]  
}    
XML
<airports>    
  <airport>  
    <airport_id>3415</airport_id>
    <icao>OMAA</icao>
    <iata>AUH</iata>
    <faa/>
    <airport_name>Abu Dhabi International</airport_name>
    <city>Abu Dhabi</city>
    <subdivision_name>Abu Dhabi</subdivision_name>
    <country_name>UNITED ARAB EMIRATES</country_name>
    <iso_country_name>UNITED ARAB EMIRATES</iso_country_name>
    <airport_of_entry>Yes</airport_of_entry>
    <last_edited>24/2/2014</last_edited>
  </airport>  
  <airport>  
    <airport_id>3416</airport_id>
    <icao>OMAD</icao>
    <iata>AZI</iata>
    <faa/>
    <airport_name>Al Bateen Executive International</airport_name>
    <city>Abu Dhabi</city>
    <subdivision_name>Abu Dhabi</subdivision_name>
    <country_name>UNITED ARAB EMIRATES</country_name>
    <iso_country_name>UNITED ARAB EMIRATES</iso_country_name>
    <airport_of_entry>Yes</airport_of_entry>
    <last_edited>24/2/2014</last_edited>
  </airport>  
</airports>    
/airports/text
Find airports based on text search, e.g. airport name, city, ICAO/IATA
When entering the web address, please replace "XXXXXXXXXXXX" with your API key.
https://api.airportdata.com/airports/text?apikey=XXXXXXXXXXXX&search_text=abu dhabi
https://api.airportdata.com/airports/text?apikey=XXXXXXXXXXXX&search_text=abu dhabi&format=xml
Method
GET – retrieves a list of airports sorted by ICAO but optionally by name where the airport name, ICAO, IATA or FAA code or the city matches the given text string.
Query Parameters
Parameter Value Description
Search_text String Airports will be returned if the ICAO, IATA, FAA, name or city contain the Search_Text
Response
JSON
{    
  "airports": [  

{
    "airport_id": 3415,
    "icao": "OMAA",
    "iata": "AUH",
    "faa": null,
    "airport_name": "Abu Dhabi International"
    "city": "Abu Dhabi"
    "country_name": "UNITED ARAB EMIRATES"
    "iso_country_name": "UNITED ARAB EMIRATES"
    "airport_of_entry": "Yes"
    "last_edited": "24/2/2014"
  },  

{
    "airport_id": 3416,
    "icao": "OMAD",
    "iata": "AZI",
    "faa": null,
    "airport_name": "Al Bateen Executive International"
    "city": "Abu Dhabi"
    "country_name": "UNITED ARAB EMIRATES"
    "iso_country_name": "UNITED ARAB EMIRATES"
    "airport_of_entry": "Yes"
    "last_edited": "24/2/2014"
  }  
  ]  
}    
XML
<airports>    
  <airport>  
    <airport_id>3415</airport_id>
    <icao>OMAA</icao>
    <iata>AUH</iata>
    <faa/>
    <airport_name>Abu Dhabi International</airport_name>
    <city>Abu Dhabi</city>
    <subdivision_name>Abu Dhabi</subdivision_name>
    <country_name>UNITED ARAB EMIRATES</country_name>
    <iso_country_name>UNITED ARAB EMIRATES</iso_country_name>
    <airport_of_entry>Yes</airport_of_entry>
    <last_edited>24/2/2014</last_edited>
  </airport>  
  <airport>  
    <airport_id>3416</airport_id>
    <icao>OMAD</icao>
    <iata>AZI</iata>
    <faa/>
    <airport_name>Al Bateen Executive International</airport_name>
    <city>Abu Dhabi</city>
    <subdivision_name>Abu Dhabi</subdivision_name>
    <country_name>UNITED ARAB EMIRATES</country_name>
    <iso_country_name>UNITED ARAB EMIRATES</iso_country_name>
    <airport_of_entry>Yes</airport_of_entry>
    <last_edited>24/2/2014</last_edited>
  </airport>  
</airports>    
/faa5010lid
Returns list of valid FAA identifiers
When entering the web address, please replace "XXXXXXXXXXXX" with your API key.
https://api.airportdata.com/faa5010lid?apikey=XXXXXXXXXXXX
https://api.airportdata.com/faa5010lid?apikey=XXXXXXXXXXXX&format=xml
Method
GET – retrieves a list of valid FAA identifiers, including facility name and facility type.
Response
JSON
{    
  "FAA5010Airports": [  

{
    "faaAirportId": "00A",
    "name": "TOTAL RF",
    "type": "HELIPORT"
  },  

{
    "faaAirportId": "00AA",
    "name": "AERO B RANCH",
    "type": "AIRPORT"
  },  

{
    "faaAirportId": "00AK",
    "name": "LOWELL FIELD",
    "type": "AIRPORT"
  },  

{
    "faaAirportId": "00AL",
    "name": "EPPS AIRPARK",
    "type": "AIRPORT"
  },  
  ]  
}    
XML
<FAA5010Airports>    
  <FAA5010Airport>  
    <faaAirportId>00A</faaAirportId>
    <name>TOTAL RF</name>
    <type>HELIPORT</type>
  </FAA5010Airport>  
  <FAA5010Airport>  
    <faaAirportId>00AA</faaAirportId>
    <name>AERO B RANCH</name>
    <type>AIRPORT</type>
  </FAA5010Airport>  
  <FAA5010Airport>  
    <faaAirportId>00AK</faaAirportId>
    <name>LOWELL FIELD</name>
    <type>AIRPORT</type>
  </FAA5010Airport>  
  <FAA5010Airport>  
    <faaAirportId>00AL</faaAirportId>
    <name>EPPS AIRPARK</name>
    <type>AIRPORT</type>
  </FAA5010Airport>  
</FAA5010Airports>    
 
 

 
 
Informa Markets Copyright © 2021. All rights reserved. Informa Markets, a trading division of Informa PLC.