Developers

Developers

Aviation Edge API for Developers

Our database is divided between static and dynamic data. Static data is that what does not frequently change but due to the massive size of our database, there are constant updates. Think about airport and airline information. The dynamic data is that what changes more frequently or uses our software to turn it into useful tools. Think about flight tracking and airport timetables.

It’s a REST API so depending on the development language you use, you can find the suitable method to develop it. A way to try the API is by getting your free API key and then testing it on our testing page.

 

You can find the examples of each endpoint below. The layout of the GET requests are as follows:

For an entire dataset, when available:
https://aviation-edge.com/api/public/[ENDPOINT]?key=[API KEY]

For specific string value information:
https://aviation-edge.com/api/public/[ENDPOINT]?key=[API KEY]&[STRING]=[VALUE]


For further information:

The Software Development Kit (SDK) on our Github.
REST/JSON in Android, follow this tutorial.

 

Dynamic aviation API

This segment explains the dynamic aviation APIs and tools that we include when you sign up for our services. In case you haven’t signed up for our services yet, you can do so here. Once you have your own API key, you can start testing on this page.

Flight Tracker API

Request

For information about all flights in the world
GET http://aviation-edge.com/api/public/flights?key=api_key

For information about a specific flight based on:
Flight IATA Number:
GET http://aviation-edge.com/api/public/flights?key=api_key&flight[iataNumber]=W8519

For information about a specific flight based on:
Airlines:
GET http://aviation-edge.com/api/public/flights?key=api_key&airline[iataCode]=W8

Departure location:
GET http://aviation-edge.com/api/public/flights?key=api_key&departure[iataCode]=MAD 

Arrival location:
GET http://aviation-edge.com/api/public/flights?key=api_key&arrival[iataCode]=GIG

Response

[
{
“geography”: {
“latitude”: 43.5033,
“longitude”: -79.1297,
“altitude”: 7833.36,
“direction”: 70
},
“speed”: {
“horizontal”: 833.4,
“isGround”: 0,
“vertical”: 0
},
“departure”: {
“iataCode”: “YHM”,
“icaoCode”: “CYHM”
},
“arrival”: {
“iataCode”: “YQM”,
“icaoCode”: “CYQM”
},
“aircraft”: {
“icaoCode”: “B763”,
“regNumber”: “CGYAJ”,
“icao24”: “C08412”
},
“airline”: {
“iataCode”: “W8”,
“icaoCode”: “CJT”
},
“flight”: {
“iataNumber”: “W8620”,
“icaoNumber”: “CJT620”,
“number”: “620”
},
“system”: {
“updated”: 1513148168,
“squawk”: “0000”
},
“status”: “en-route”
}
]
 

Airport Timetable API

Request

For the departure timetable of a certain airport.
GET http://aviation-edge.com/api/public/timetable?key=api_key&iataCode=JFK&type=departure

For the arrival timetable of a certain airport.
GET http://aviation-edge.com/api/public/timetable?key=api_key&iataCode=JFK&type=arrival

Response

[
{
“type”: “departure”,
“status”: “landed”,
“departure”: {
“iataCode”: “JFK”,
“icaoCode”: “KJFK”,
“scheduledTime”: “2017-12-11T01:06:00.000”,
“estimatedRunway”: “2017-12-11T02:07:00.000”,
“actualRunway”: “2017-12-11T02:07:00.000”
},
“arrival”: {
“iataCode”: “CVG”,
“icaoCode”: “KCVG”,
“estimatedRunway”: “2017-12-11T03:38:00.000”,
“actualRunway”: “2017-12-11T03:38:00.000”
},
“airline”: {
“name”: “Atlas Air”,
“iataCode”: “5Y”,
“icaoCode”: “GTI”
},
“flight”: {
“number”: “302”,
“iataNumber”: “5Y302”,
“icaoNumber”: “GTI302”
}

Etc.

]
 

Air routes API

Request

For information about all routes.
 GET http://aviation-edge.com/api/public/routes?key=api_key&limit=1000&offset=0

For information about a specific route.
 GET http://aviation-edge.com/api/public/routes?key=api_key&departureIata=OTP&departureIcao=LROP&airlineIata=0B&airlineIcao=BMS&flightNumber=101

For information about a specific departure airport.
 GET http://aviation-edge.com/api/public/routes?key=api_key&departureIata=OTP&departureIcao=LROP

For information about a specific airline.
 GET http://aviation-edge.com/api/public/routes?key=api_key&airlineIata=0B&airlineIcao=BMS

Response

[
{
“departureIata”: “OTP”,
“departureIcao”: “LROP”,
“departureTerminal”: null,
“departureTime”: “09:15:00”,
“arrivalIata”: “TRN”,
“arrivalIcao”: “LIMF”,
“arrivalTerminal”: null,
“arrivalTime”: “10:45:00”,
“airlineIata”: “0B”,
“airlineIcao”: “BMS”,
“flightNumber”: “101”,
“codeshares”: null,
“regNumber”: “YR-BAP”
}
]

Autocomplete API

Request

To receive a response of possible options for autocomplete based on a query.
GET http://aviation-edge.com/api/public/autocomplete?key=api_key&query=amsterdam

Response

[
{
“countries”: null,
“citiesByCountries”: null,
“airportsByCountries”: null,
“cities”: [
{
“code”: “AMS”,
“name”: “Amsterdam”,
“cityCode”: “AMS”,
“cityName”: “Amsterdam”,
“countryCode”: “NL”,
“countryName”: “Netherlands”,
“lat”: 52.3730556,
“lng”: 4.8922222,
“timezone”: “Europe/Amsterdam”,
“type”: “city”
}
],
“airports”: [
{
“code”: “ZYA”,
“name”: “Amsterdam Centraal Railway Station”,
“cityCode”: “AMS”,
“cityName”: “Amsterdam”,
“countryCode”: “NL”,
“countryName”: “Netherlands”,
“lat”: 52.3730556,
“lng”: 4.8922222,
“timezone”: “Europe/Amsterdam”,
“type”: “rail_station”,
“isRailRoad”: 1,
“isBusStation”: 0
},
{
“code”: “AMS”,
“name”: “Schiphol”,
“cityCode”: “AMS”,
“cityName”: “Amsterdam”,
“countryCode”: “NL”,
“countryName”: “Netherlands”,
“lat”: 52.30907,
“lng”: 4.763385,
“timezone”: “Europe/Amsterdam”,
“type”: “airport”,
“isRailRoad”: 0,
“isBusStation”: 0
}
],
“airportsByCities”: [
{
“code”: “AMS”,
“name”: “Schiphol”,
“cityCode”: “AMS”,
“cityName”: “Amsterdam”,
“countryCode”: “NL”,
“countryName”: “Netherlands”,
“lat”: 52.30907,
“lng”: 4.763385,
“timezone”: “Europe/Amsterdam”,
“type”: “airport”,
“isRailRoad”: 0,
“isBusStation”: 0
},
{
“code”: “ZYA”,
“name”: “Amsterdam Centraal Railway Station”,
“cityCode”: “AMS”,
“cityName”: “Amsterdam”,
“countryCode”: “NL”,
“countryName”: “Netherlands”,
“lat”: 52.3730556,
“lng”: 4.8922222,
“timezone”: “Europe/Amsterdam”,
“type”: “rail_station”,
“isRailRoad”: 1,
“isBusStation”: 0
}
],
“citiesByAirports”: [
{
“code”: “AMS”,
“name”: “Amsterdam”,
“cityCode”: “AMS”,
“cityName”: “Amsterdam”,
“countryCode”: “NL”,
“countryName”: “Netherlands”,
“lat”: 52.3730556,
“lng”: 4.8922222,
“timezone”: “Europe/Amsterdam”,
“type”: “city”
}

Etc.

]

Nearby service API

Request

For airports and cities nearby a certain latitude or longitude, within a certain distance.
GET http://aviation-edge.com/api/public/nearby?key=api_key&lat=-5.466667&lng=122.6333&distance=100

Response

[
 {
 “code”: “BUW”,
 “icao”: “WAWB”,
 “name”: “Baubau”,
 “cityCode”: “BUW”,
 “cityName”: “Baubau”,
 “countryCode”: “ID”,
 “countryName”: “Indonesia”,
 “lat”: -5.466667,
 “lng”: 122.63333,
 “timezone”: “Asia/Makassar”,
 “type”: “airport”,
 “isRailRoad”: 0,
 “isBusStation”: 0,
 “distance”: 0
 },
 {
 “code”: “RAQ”,
 “icao”: “WAWR”,
 “name”: “Sugimanuru”,
 “cityCode”: “RAQ”,
 “cityName”: “Raha”,
 “countryCode”: “ID”,
 “countryName”: “Indonesia”,
 “lat”: -4.916667,
 “lng”: 122.583336,
 “timezone”: “Asia/Makassar”,
 “type”: “airport”,
 “isRailRoad”: 0,
 “isBusStation”: 0,
 “distance”: 61404
 }
 ]


 

 

Static data in aviation API

This segment explains our static data which you can connect to through API as well. This data does not change as frequently as the data in the dynamic segment. If you haven’t got your API key yet, get one here and to test you can go to this page.

Airlines API documentation

Request

For the entire database of airlines.
GET https://aviation-edge.com/api/public/airlineDatabase?key=api_key

For information about a specific airline, you can search based on IATA airline code.
GET https://aviation-edge.com/api/public/airlineDatabase?key=api_key&codeIataAirline=AA

or you can search for the airlines based on the country codes.
GET https://aviation-edge.com/api/public/airlineDatabase?key=api_key&codeIso2Country=US

Response

[
{
"airlineId": "1",
"nameAirline": "American Airlines",
"codeIataAirline": "AA",
"iataPrefixAccounting": "1",
"codeIcaoAirline": "AAL",
"callsign": "AMERICAN",
"type": "scheduled",
"statusAirline": "active",
"sizeAirline": "963",
"ageFleet": "10.9",
"founding": "1934",
"codeHub": "DFW",
"nameCountry": "United States",
"codeIso2Country": "US"
}
]

Airport API documentation

Request

For the entire database of airports.
GET https://aviation-edge.com/api/public/airportDatabase?key=api_key

For information about a specific airport, you can search based on IATA code.
GET https://aviation-edge.com/api/public/airportDatabase?key=api_key&codeIataAirport=AAH

or you can search for the airports based on the country code.
GET https://aviation-edge.com/api/public/airportDatabase?key=api_key&codeIso2Country=DE

Response

[
 {
 "airportId": "7",
 "nameAirport": "Aachen/Merzbruck",
 "codeIataAirport": "AAH",
 "codeIcaoAirport": "EDKA",
 "latitudeAirport": "50.75",
 "longitudeAirport": "6.133333",
 "geonameId": "3247449",
 "timezone": "Europe/Berlin",
 "GMT": "1",
 "phone": "",
 "nameCountry": "Germany",
 "codeIso2Country": "DE",
 "codeIataCity": "AAH"
 }
 ]

Airplanes API documentation

Request

For the entire database of airplanes.
 GET https://aviation-edge.com/api/public/airplaneDatabase?key=api_key

For information about a specific airplane, you can search based on registration number.
 GET https://aviation-edge.com/api/public/airplaneDatabase?key=api_key&numberRegistration=HB-JVE

or you can search for the airplanes based on the hex ICAO code.
 GET https://aviation-edge.com/api/public/airplaneDatabase?key=api_key&hexIcaoAirplane=4B19EA

For information about airplanes of a specific airline, you can search based on airline iata code.
 GET https://aviation-edge.com/api/public/airplaneDatabase?key=api_key&codeIataAirline=0B

Response

[
{
"airplaneId": "55",
"numberRegistration": "HB-JVE",
"productionLine": "Fokker 28/70/100",
"airplaneIataType": "F28 MK0100",
"planeModel": "F-100",
"modelCode": "F100",
"hexIcaoAirplane": "4B19EA",
"codeIataPlaneShort": "100",
"codeIataPlaneLong": "F100",
"constructionNumber": "11459",
"numberTestRgistration": "PH-EZD",
"rolloutDate": "0000-00-00",
"firstFlight": "1993-05-31T22:00:00.000Z",
"deliveryDate": "1993-06-29T22:00:00.000Z",
"registrationDate": "2004-05-11T22:00:00.000Z",
"lineNumber": "",
"planeSeries": "",
"codeIataAirline": "2L",
"codeIcaoAirline": "",
"planeOwner": "",
"enginesCount": "2",
"enginesType": "JET",
"planeAge": "24",
"planeStatus": "active",
}
]

City API documentation

Request

For the entire database of city benchmark.
GET https://aviation-edge.com/api/public/cityDatabase?key=api_key

For information about a specific city benchmark information, you can search based on IATA code.
GET https://aviation-edge.com/api/public/cityDatabase?key=api_key&codeIataCity=AAA

or you can search for the city benchmark information based on the country code.
GET https://aviation-edge.com/api/public/cityDatabase?key=api_key&codeIso2Country=PF

Response

[
{
"cityId": "1",
"nameCity": "Anaa",
"codeIataCity": "AAA",
"codeIso2Country": "PF",
"latitudeCity": "-17.05",
"longitudeCity": "-145.41667",
"timezone": "Pacific/Tahiti",
"GMT": "-10",
"geonameId": "0"
}
]

Country API documentation

Request

For the entire database of countries.
 GET https://aviation-edge.com/api/public/countryDatabase?key=api_key

For information about a specific country, you can search based on ISO code.
 GET https://aviation-edge.com/api/public/countryDatabase?key=api_key&codeIso2Country=AD

or you can search for the country information based on the country name.
 GET https://aviation-edge.com/api/public/countryDatabase?key=api_key&nameCountry=Andorra

Response

[
{
"countryId": "1",
"nameCountry": "Andorra",
"codeIso2Country": "AD",
"codeIso3Country": "AND",
"numericIso": "20",
"population": "84000",
"capital": "Andorra la Vella",
"continent": "EU",
"nameCurrency": "Euro",
"codeCurrency": "EUR",
"codeFips": "AN",
"phonePrefix": "376"
}
]

Aviation taxes API documentation

Request

For the entire database of tax code IDs.
GET https://aviation-edge.com/api/public/taxDatabase?key=api_key

For information about a specific tax code ID, you can search based on the tax code.
GET https://aviation-edge.com/api/public//taxDatabase?key=api_key&codeIataTax=AC

Response

[
{
"taxId": "2",
"nameTax": "Value Added Tax",
"codeIataTax": "AC"
}
]

Airline Benchmark API documentation

Request

For the entire database of airlines benchmark.
GET https://aviation-edge.com/api/public/benchmarkAirlines?key=api_key

For information about a specific airline benchmark information, you can search based on IATA airline code.
GET https://aviation-edge.com/api/public/benchmarkAirlines?key=api_key&codeIataAirline=AA

or you can search for the airline benchmark information based on the country codes.
GET https://aviation-edge.com/api/public/benchmarkAirlines?key=api_key&codeIso2Country=US

Response

[
{
"benchmarkAirlinesId": "1",
"nameAirline": "American Airlines",
"codeIataAirline": "AA",
"codeIcaoAirline": "AAL",
"nameCountry": "United States",
"codeIso2Country": "US",
"statusAirline": "active",
"type": "scheduled",
"founding": "1934",
"ageFleet": "10.9",
"sizeAirline": "963",
"website": "aa.com",
"twitter": "twitter.com/AmericanAir",
"facebook": "facebook.com/AmericanAirlines"
}
]

Airport Benchmark API documentation

Request

For the entire database of airport benchmark.
GET https://aviation-edge.com/api/public/benchmarkAirports?key=api_key

For information about a specific airport benchmark information, you can search based on IATA code.
GET https://aviation-edge.com/api/public/benchmarkAirports?key=api_key&codeIataAirport=AAA

or you can search for the airport benchmark information based on the country code.
GET https://aviation-edge.com/api/public/benchmarkAirports?key=api_key&codeIso2Country=PF

Response

[
{
"benchmarkAirportsId": "1",
"nameAirport": "Anaa",
"codeIataAirport": "AAA",
"nameCountry": "French Polynesia",
"codeIso2Country": "PF",
"popularity": "0",
"website": ""
}
]

City Benchmark API documentation

Request

For the entire database of city benchmark.
GET https://aviation-edge.com/api/public/benchmarkCities?key=api_key

For information about a specific city benchmark information, you can search based on IATA code.
GET https://aviation-edge.com/api/public/benchmarkCities?key=api_key&codeIataCity=AAA

or you can search for the city benchmark information based on the country code.
GET https://aviation-edge.com/api/public/benchmarkCities?key=api_key&codeIso2Country=PF

Response

[
{
"benchmarkCitiesId": "1",
"nameCity": "Anaa",
"codeIataCity": "AAA",
"nameCountry": "French Polynesia",
"codeIso2Country": "PF",
"popularity": "0"
}
]