Aviation Edge API for Developers – V1

 

Attention

This is the developer’s page of version 1 of our API. We recommend all users to switch to this (V2). Those registered after September 10th of 2018, can only use V2 which contains everything from V1 and more. 

Find the V2 documentation here

 


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 data

Flight Tracker

Request

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

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

Routes

Request

For information about routes from Airports or Airlines or Flights.
GET http://aviation-edge.com/api/public/routes?key=api_key&departureIata=OTP
GET http://aviation-edge.com/api/public/routes?key=api_key&departureIcao=LROP
GET http://aviation-edge.com/api/public/routes?key=api_key&airlineIata=0B
GET http://aviation-edge.com/api/public/routes?key=api_key&airlineIcao=BMS
GET http://aviation-edge.com/api/public/routes?key=api_key&flightNumber=101

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

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

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
},
Etc.

 

Static aviation data

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

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

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

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

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

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

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 

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 

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

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 

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

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 

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"
}
]
Close Menu
×

Cart