Airportdata - Web Service > Technical Specifications

/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

Show Example +/-

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

Show Example +/-

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

Show Example +/-

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

Show Example +/-

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

Show Example +/-

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/FAA

Show Example +/-

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

Show Example +/-

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>

Search Resources