Airports

An airport is any landing place for aircraft, including seaports and heliports.

Entry point
https://www.avdelphi.com/api/1.00/airports.svc
Parameter Type Values
api_key
mandatory Your API Key
api_password
mandatory Your API Password. Send this OR an access_token
api_access_token
mandatory Your API access token which can be used instead of sending your password.
cmd
mandatory API Command
itemlist
mandatory List of fields to return. Each command has a specific list of items that can be returned.
format
optional Data return type XML,JSON,CSV or CSV-
  • JSON is the default when no format parameter is specified
  • CSV output starts with a series of comment lines - starting with the # character. You may need to remove these before importing the CSV data.
  • CSV- output omits the comment lines - including any error messages.
search parameter
see note below Each command has a set of parameters that can be specified to identify the target data, such as registration, serial number etc.

Examples

Note When using the TEST credentials (TESTAPIKEY & TESTAPIKEYPASSWORD) the result airport will always be CODE_IATA=ZRH / CODE_ICAO=LSZH

Get basic identity information for an airport by IATA code
https://www.avdelphi.com/api/1.0/airports.svc?api_key=TESTAPIKEY&api_password=TESTAPIKEYPASSWORD&cmd=info&code_iata=zrh&itemlist=title;code_iata;code_icao


Result (JSON)
{
	"api":"airports",
	"version":1,
	"command":"info",
	"num_results":1,
	"result_type":"valid",
	"results_limit":2,
	"rate_limit":
	{
		"airports":
		{
			"current":5,
			"maximum":5000
		}
	},
	"result":
	[
		{
			"code_iata":"ZRH",
			"code_icao":"LSZH",
			"title":"Z\u00fcrich"
		}
	]
}


Get basic identity information for an airport by ICAO code
https://www.avdelphi.com/api/1.0/airports.svc?api_key=TESTAPIKEY&api_password=TESTAPIKEYPASSWORD&cmd=info&code_icao=lszh&itemlist=title;code_iata;code_icao


Result (JSON)
{
	"api":"airports",
	"version":1,
	"command":"info",
	"num_results":1,
	"result_type":"valid",
	"results_limit":2,
	"rate_limit":
	{
		"airports":
		{
			"current":5,
			"maximum":5000
		}
	},
	"result":
	[
		{
			"code_iata":"ZRH",
			"code_icao":"LSZH",
			"title":"Z\u00fcrich"
		}
	]
}


Get basic identity information for an airport by name
https://www.avdelphi.com/api/1.0/airports.svc?api_key=TESTAPIKEY&api_password=TESTAPIKEYPASSWORD&cmd=info&name=zurich&itemlist=title;code_iata;code_icao


Result (JSON)
{
	"api":"airports",
	"version":1,
	"command":"info",
	"num_results":2,
	"result_type":
	"valid",
	"results_limit":3,
	"rate_limit":
	{
		"airports":
		{
			"current":8,
			"maximum":5000
		}
	},
	"result":
	[
		{
			"code_iata":"",
			"code_icao":"",
			"title":"Universit\u00e4tsspital Z\u00fcrich"
		},
		{
			"code_iata":"ZRH",
			"code_icao":"LSZH",
			"title":"Z\u00fcrich"
		}
	]
}


https://www.avdelphi.com/api/1.0/airports.svc?api_key=TESTAPIKEY&api_password=TESTAPIKEYPASSWORD&cmd=info&name=zurich&itemlist=title;code_iata;code_icao&format=csv


Result (CSV)
#api=airports
#version=1
#command=info
#result_type=valid
#code_iata,code_icao,title
,,"Universitätsspital Zürich"
ZRH,LSZH,Zürich



https://www.avdelphi.com/api/1.0/airports.svc?api_key=TESTAPIKEY&api_password=TESTAPIKEYPASSWORD&cmd=info&name=zurich&itemlist=title;code_iata;code_icao&format=xml


Result (XML)
<?xml version="1.0"?>
	<data>
		<api>airports</api>
		<version>1</version>
		<command>get</command>
		<num_results>2</num_results>
		<result_type>valid</result_type>
		<results_limit>3</results_limit>
		<rate_limit>
			<airports>
				<current>11</current>
				<maximum>5000</maximum>
			</airports>
		</rate_limit>
		<result>
			<item0>
				<code_iata/>
				<code_icao/>
				<title>Universitätsspital Zürich</title>
			</item0>
			<item1>
				<code_iata>ZRH</code_iata>
				<code_icao>LSZH</code_icao>
				<title>Zürich</title>
			</item1>
		</result>
	</data>

Pricing

Access to this API is based on a per airport per month pricing plan. Volume discounts apply. Contact your API team using the contact form below to create or edit your plan.
Search is included with all pricing plans.

Mandatory Parameters

api_key

TypeMandatory
ContentHexadecimal value of your API key.
Get your API key here if you don't have one.
Case sensitiveYES
Example
api_key=NTlhZGUl7kZW

Back to top 

api_password

TypeMandatory (You must send either password or access token with each request)
ContentHexadecimal value of your API password.
Get your API key here if you don't have one.
Case sensitiveYES
Example
api_password=ciUyQmdPWTJaTGNQc2pkU05tRlVNaWZZ11NpdCUyRmVpVEF6THBm7SUzRA

Back to top 

api_access_token

TypeMandatory (You must send either password or access token with each request)
ContentHexadecimal value of your API access token.
Click on any API Key here to manage access tokens.
Case sensitiveYES
Example
api_access_token=2d1a099fd880c0fcfd6fd5e63a769e11b2c2db92

Back to top 

Commands

cmd

TypeMandatory
ContentAPI command to execute
Case sensitiveNo
Command Purpose
info Retrieve information about a specific airport. The list of data fields returned is specified using the itemlist parameter.
weather Gets the current weather conditions at the airport.
metar Gets the current METAR report for the airport
taf Gets the current TAF (Terminal Area Forecast) for the airport
notam Gets the most recent NOTAMs for the airport
charts Gets airport charts where available. NOTE: Charts should not be used for aeronautical operations.
news Show any recent news items relating to this airport.
metsat Get recent weather satellite images covering this airport
images Get images for this airport
Example
cmd=info
cmd=weather
cmd=metar

Back to top 

info

FunctionRetrieve information about a specific airport. The list of data fields returned is specified using the itemlist parameter.
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
code_icao4 letter ICAO allocated code for the airport
code_iata3 letter IATA allocated code for the airport 
nameAny other name used for this airport
titleCommon name for the airport
Example

code_icao=kjfk

Back to commands 

weather

FunctionGets the current weather conditions at the airport.
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
code_icao4 letter ICAO allocated code for the airport
code_iata3 letter IATA allocated code for the airport 
Example

code_iata=gva

Back to commands 

metar

FunctionGets the current METAR report for the airport
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
code_icao4 letter ICAO allocated code for the airport
code_iata3 letter IATA allocated code for the airport 
Example

code_icao=lszh

Back to commands 

taf

FunctionGets the current TAF (Terminal Area Forecast) for the airport
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
code_icao4 letter ICAO allocated code for the airport
code_iata3 letter IATA allocated code for the airport 
Example

code_icao=klax

Back to commands 

notam

FunctionGets the most recent NOTAMs for the airport
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
code_icao4 letter ICAO allocated code for the airport
code_iata3 letter IATA allocated code for the airport 
Example

code_icao=kden

Back to commands 

charts

FunctionGets airport charts where available. NOTE: Charts should not be used for aeronautical operations.
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
code_icao4 letter ICAO allocated code for the airport
code_iata3 letter IATA allocated code for the airport 
Example

code_icao=tjmz

Back to commands 

news

FunctionShow any recent news items relating to this airport.
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
code_icao4 letter ICAO allocated code for the airport
code_iata3 letter IATA allocated code for the airport 
Example

code_iata=lhr

Back to commands 

metsat

FunctionGet recent weather satellite images covering this airport
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
code_icao4 letter ICAO allocated code for the airport
code_iata3 letter IATA allocated code for the airport 
Example

code_iata=muc

Back to commands 

images

FunctionGet images for this airport
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
code_icao4 letter ICAO allocated code for the airport
Example

code_icao=lszh

Back to commands 

Optional Parameters

format

TypeOptional
ContentSpecifies the data return format JSON,XML or CSV(-). By default, data is returned as JSON.
Case sensitiveNo
Example
format=xml
format=csv
format=csv-
format=json

Back to top 

itemlist

TypeOptional depending on command used. Some commands return default data, others allow you to specify which fields to return.
ContentList of fields to retrieve separated with semi-colons.
Case sensitiveNo
Fieldname Description
code_iata 3 letter IATA allocated code for the airport
code_icao 4 letter ICAO allocated code for the airport
title Common name for the airport
name Any other name used for this airport
common_name The common name for this airport
alternate_spellings Alternate spellings for the airport name, including language variants
display_names
aka
location
city
zip_code
region
country
country_iso
Example
itemlist=code_iata;code_icao;title

Back to top