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.

Airlines

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”
}
]

Airplanes

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”,
}
]

Airport

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”
}
]

Airline Benchmark

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

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

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”
}
]

City

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

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”
}
]

Taxes

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”
}
]

 

Routes

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

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

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

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
}
]

Flight Tracker

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

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.

]

Close Menu
×

Cart