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/v2/public/[ENDPOINT]?key=[API KEY]
For specific string value information:
https://aviation-edge.com/v2/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.

  • Flight Tracker API
  • SCHEDULES api
  • Airline Routes API
  • NearBy API
  • Autocomplete API
  • HISTORICAL SCHEDULES API
  • FUTURE SCHEDULES API
  • Satellite TrackER apı

Historical Schedules

Request

For the departure schedule of a certain airport on a certain date.
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=departure&date_from=YYYY-MM-DD

For the arrival schedule of a certain airport on a certain date.
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=arrival&date_from=YYYY-MM-DD

For the schedule of a certain airport of a certain date range (also available for arrival).
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=departure&date_from=YYYY-MM-DD&date_to=YYYY-MM-DD

For the schedule of a certain airport on a certain date (or range) but only flights with a certain status.
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=arrival&date_from=YYYY-MM-DD&date_to=YYYY-MM-DD&status=cancelled

For tracking individual historical flights.
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=departure&date_from=YYYY-MM-DD&date_to=YYYY-MM-DD&flight_number=[1234]

For filtering the flights of a certain airline from the arrival schedule of a certain airport on a certain date (also available for departure schedules and as a date range).
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=arrival&date_from=YYYY-MM-DD&&airline_iata=TK


Status can be: "active" (for departure schedules only), "landed" (for arrival schedules only), "cancelled", "unknown"
Delay amount is included in minutes if a flight was delayed at the date.
The maximum date range can be 30 days which may be reduced to 3-5 days for large airports with heavy traffic.

&code=
&type=
&date_from=

&date_to=
&dep_iataCode=
&arr_iataCode=
&airline_iata=
&flight_num=

(obligatory) Departure or arrival airport IATA code
(obligatory) Either "departure" or "arrival" as both within the same query is not possible
(obligatory) Requested date in YYYY-MM-DD format. Can be used alone for a single date or in combination with "&date_to" to define a range.

end date of the requested date range
filter of departure airport if "arrival" for "&type=" was chosen, based on the airport IATA code
filter of arrival airport if "departure" for "&type=" was chosen, based on the airport IATA code
option to filter airline based on airline IATA code
option to filter a specific flight based on its flight number


 

Response

{
"type":"arrival",
"status":"cancelled",
"departure":{"iata_code":"MLA",
"icao_code":"LMML",
"scheduled_time":"2020-07-18T08:35:00.000"},
"arrival":
{"iata_code":"LGW",
"icao_code":"EGKK",
"terminal":"S",
"scheduled_time":"2020-07-18T10:55:00.000"},
"airline":
{"name":"Air Baltic",
"iata_code":"BT",
"icao_code":"BTI"},
"flight":
{"number":"6079",
"iata_number":"BT6079",
"icao_number":"BTI6079"},
"codeshared":
{"airline":
{"name":"Air Malta",
"iata_code":"KM",
"icao_code":"AMC"},
"flight":
{"number":"116",
"iata_number":"KM116",
"icao_number":"AMC116"}
}
}
,
{
"type":"arrival",
"status":"landed",
"departure":
{"iata_code":"IST",
"icao_code":"LTFM",
"gate":"A11A",
"delay":20,
"scheduled_time":"2020-07-18T07:10:00.000",
"estimated_time":"2020-07-18T07:10:00.000",
"actual_time":"2020-07-18T07:30:00.000",
"estimated_runway":"2020-07-18T07:30:00.000",
"actual_runway":"2020-07-18T07:30:00.000"},
"arrival":
{"iata_code":"LGW",
"icao_code":"EGKK",
"terminal":"N",
"scheduled_time":"2020-07-18T09:20:00.000",
"estimated_time":"2020-07-18T08:48:00.000",
"actual_time":"2020-07-18T08:48:00.000",
"estimated_runway":"2020-07-18T08:48:00.000",
"actual_runway":"2020-07-18T08:48:00.000"},
"airline":
{"name":"Turkish Airlines",
"iata_code":"TK",
"icao_code":"THY"},
"flight":
{"number":"1981",
"iata_number":"TK1981",
"icao_number":"THY1981"
}
}
  • Airports
  • Airlines
  • Airplanes
  • Cities
  • Countries
  • Taxes
  • Aircraft Types

Airplane Database

Request

For the entire database of airplanes. 
GET https://aviation-edge.com/v2/public/airplaneDatabase?key=[API_KEY]

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

For the airplanes based on the hex ICAO code. 
GET https://aviation-edge.com/v2/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/v2/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", 

]