Airports

Examples |  Pricing |  Mandatory Parameters |  Commands |  Optional parameters

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

Get basic identity information for an airport by IATA code
https://www.avdelphi.com/api/1.0/airports.svc?api_key=TESTAPIKEY&api_access_token=TESTAPIACCESSTOKEN&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_access_token=TESTAPIACCESSTOKEN&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_access_token=TESTAPIACCESSTOKEN&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_access_token=TESTAPIACCESSTOKEN&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_access_token=TESTAPIACCESSTOKEN&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

This is a pay-as-you-go API. Simply fund your account to use it.

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 

OR

api_access_token

Type Mandatory (You must send either password or access token with each request)
Content Hexadecimal value of your API access token.
Click on any API Key here to manage access tokens.
Case sensitive YES
Example
api_access_token=2d1a099fd880c0fcfd6fd5e63a769e11b2c2db92

Back to top 


Commands

Specify the command you want using the cmd= parameter

cmd

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

Back to top 

One of the keywords listed below can be with the command.

charts

FunctionGets airport charts where available. NOTE: Charts should not be used for aeronautical operations.
Parameter(s)Multiple parameters will be ANDed together.

ParameterDescription
code_icao4 letter ICAO airport code
code_iata3 letter IATA airport code
faa_site_numberFAA site number
faa_identifier3 character FAA identifier
transport_canada_idTransport Canada numeric ID
Example
code_icao=tjmz
Back to commands 

images

FunctionGet images for this airport
Parameter(s)Multiple parameters will be ANDed together.

ParameterDescription
code_icao4 letter ICAO airport code
Example
code_icao=lszh
Back to commands 

info

FunctionRetrieve information about a specific airport. The list of data fields returned is specified using the itemlist parameter.
Parameter(s)Multiple parameters will be ANDed together.

ParameterDescription
code_icao4 letter ICAO airport code
code_iata3 letter IATA airport code
nameAirport name
titleAirport title, name or other text
faa_site_numberFAA site number
faa_identifier3 character FAA identifier
transport_canada_idTransport Canada numeric ID
Example
code_icao=kjfk
Back to commands 

metar

FunctionGets the current METAR report for the airport
Parameter(s)Multiple parameters will be ANDed together.

ParameterDescription
code_icao4 letter ICAO airport code
code_iata3 letter IATA airport code
faa_site_numberFAA site number
faa_identifier3 character FAA identifier
transport_canada_idTransport Canada numeric ID
Example
code_icao=lszh
Back to commands 

metsat

FunctionGet recent weather satellite images covering this airport
Parameter(s)Multiple parameters will be ANDed together.

ParameterDescription
code_icao4 letter ICAO airport code
code_iata3 letter IATA airport code
faa_site_numberFAA site number
faa_identifier3 character FAA identifier
transport_canada_idTransport Canada numeric ID
Example
code_iata=muc
Back to commands 

news

FunctionShow any recent news items relating to this airport.
Parameter(s)Multiple parameters will be ANDed together.

ParameterDescription
code_icao4 letter ICAO airport code
code_iata3 letter IATA airport code
faa_site_numberFAA site number
faa_identifier3 character FAA identifier
transport_canada_idTransport Canada numeric ID
Example
code_iata=lhr
Back to commands 

notam

FunctionGets the most recent NOTAMs for the airport
Parameter(s)Multiple parameters will be ANDed together.

ParameterDescription
code_icao4 letter ICAO airport code
code_iata3 letter IATA airport code
atc_zoneATC Zone Code
Example
code_icao=kden
Back to commands 

taf

FunctionGets the current TAF (Terminal Area Forecast) for the airport
Parameter(s)Multiple parameters will be ANDed together.

ParameterDescription
code_icao4 letter ICAO airport code
code_iata3 letter IATA airport code
faa_site_numberFAA site number
faa_identifier3 character FAA identifier
transport_canada_idTransport Canada numeric ID
Example
code_icao=klax
Back to commands 

weather

FunctionGets the current weather conditions at the airport.
Parameter(s)Multiple parameters will be ANDed together.

ParameterDescription
code_icao4 letter ICAO airport code
code_iata3 letter IATA airport code
faa_site_numberFAA site number
faa_identifier3 character FAA identifier
transport_canada_idTransport Canada numeric ID
Example
code_iata=gva
Back to commands 


Optional Parameters

These parameters are not required but can be added if needed. If not specified, some items default to preset values.

format

Type Optional
Content Specifies the data return format JSON,XML or CSV(-). By default, data is returned as JSON.
Case sensitive No
Default json
Example
format=xml
format=csv
format=csv-
format=json

Back to top 

itemlist

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

Back to top