Developers - Aviation database and API

Flight Tracking

Request

For information about all flights in the world
GET https://aviation-edge.com/v2/public/flights?key=[API_KEY]&limit=30000

You can combine any type of String and Value to make very specific calls. The below Strings are all possible to use:

&depIata=
&depIcao=
&arrIata=
&arrIcao=
&aircraftIcao=
&regNum=
&aircraftIcao24=
&airlineIata=
&airlineIcao=
&flightIata=
&flightIcao=
&flightNum=
&status=
&limit=
&lat=&lng=&distance=

Departure airport IATA code
Departure airport ICAO code
Arrival airport IATA code
Arrival airport ICAO code
Aircraft ICAO code
Aircraft registration number
Aircraft ICAO24 code
Airline IATA code
Airline ICAO code
Flight IATA code
Flight ICAO code
Flight number
Status of the flight (started, en-route, landed, unknown)
Limit value for output
Flights within a specified circle based on the coordinates (distance is radius in km)

Examples

Specific flight based on: Flight IATA Number:
GET https://aviation-edge.com/v2/public/flights?key=[API_KEY]&flightIata=W8519

All flights of a specific Airlines:
GET https://aviation-edge.com/v2/public/flights?key=[API_KEY]&airlineIata=W8

Flights from departure location:
GET https://aviation-edge.com/v2/public/flights?key=[API_KEY]&depIata=MAD

Flights from arrival location:
GET https://aviation-edge.com/v2/public/flights?key=[API_KEY]&arrIata=GIG

Flights within a circle area based on lat and lng values and radius as the distance:
GET https://aviation-edge.com/v2/public/flights?key=[API_KEY]&lat=51.5074&lng=0.1278&distance=100&arrIata=LHR

Combinations: two airports and a specific airline flying between them:
GET https://aviation-edge.com/v2/public/flights?key=[API_KEY]&depIata=ATL&arrIata=ORD&airlineIata=UA

Response

[
{
"geography": {
"latitude": 43.50,
"longitude": -79.12,
"altitude": 7833.36,
"direction": 70
},
"speed": {
"horizontal": 833.431,
"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"
}
]

Flight Schedules and Timetables

Request

For the departure schedule of a certain airport.
GET https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=JFK&type=departure

For the arrival schedule of a certain airport.
GET https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=JFK&type=arrival

Status can be: (landed, scheduled, cancelled, active, incident, diverted, redirected, unknown)

&iataCode=
&type=

&status=
&dep_iataCode=
&dep_icaoCode=
&dep_terminal=
&dep_delay=
&dep_schTime=
&dep_estTime=
&dep_actTime=
&dep_estRunway=
&dep_actRunway=

&arr_iataCode=
&arr_icaoCode=
&arr_terminal=
&arr_delay=
&arr_schTime=
&arr_estTime=
&arr_actTime=
&arr_estRunway=
&arr_actRunway=

&airline_name=
&airline_iata=
&airline_icao=
&flight_num=
&flight_iata=
&flight_icao=

&codeshared=

&lang=

(obligatory) The IATA code of the airport you'd like to request data from.
(obligatory) Flight type: departure or arrival

The status of the flight: landed, scheduled, cancelled, active, incident, diverted, redirected, unknown
The IATA code of the departure airport (JFK, AMS, CDG, etc)
The ICAO code of the departure airport (KJFK, EHAM, LFPG, etc)
The terminal at the departure airport (1, 2, 3, 4, etc)
The delay in minutes at departure (10, 20, 45, etc) it is not possible to set a delay range
The scheduled flight's departure in the following format: YYYY-MM-DDT00:00:00.000 For example: 2019-06-07T05:00:00.000
The estimated departure time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2019-06-07T05:00:00.000
The actual flight departure time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2019-06-07T05:00:00.000
The estimated departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2019-06-07T05:00:00.000
The actual departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2019-06-07T05:00:00.000

The IATA code of the arrival airport (JFK, AMS, CDG, etc)
The ICAO code of the arrival airport (KJFK, EHAM, LFPG, etc)
The terminal at the arrival airport (1, 2, 3, 4, etc)
The delay in minutes at arrival (10, 20, 45, etc) it is not possible to set a delay range
The scheduled flight's arrival in the following format: YYYY-MM-DDT00:00:00.000 For example: 2019-06-07T05:00:00.000
The estimated arrival time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2019-06-07T05:00:00.000
The actual flight arrival time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2019-06-07T05:00:00.000
The estimated arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2019-06-07T05:00:00.000
The actual arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2019-06-07T05:00:00.000

Name of the airline (Air France, American Airlines, Delta Air Lines, etc) (may need air%20france, american%20airlines, delta%20air%20lines)
IATA code of airline
ICAO code of airline
The flight number based on 1 to 4 digits, for example: 171
The flight iata number consisting of digits and letters, usually of the airline iata code. For example: AA171
The flight icao number consisting of digits and letters, usually the airline icao code. For example: AAL171

If the flight is codeshared, this data will be included. If you don't want codeshared flights, you can input null

Translations are available of the airport names, city names and country names to 43 different languages. See details below.

Translations

Using the translations function in the API with &lang= will slow down the API calls when it involves a lot of translations of airports, cities or countries. Therefor it is recommended to use it in combination with other filters to reduce the amount of data that you receive in the response.

The languages and code available:

fr
ar
fa
ru
zh_hans
zh, zh_hant
es
hi
pt
ja
de
jv
ko
tu
vi
it
ur
pl
uk
ro
az
ha
my
th
nl
yo
id
sv
no
he
da
ms
fl
fi
cs
sk
hy
bg
ka
el
hr
hu
lt
lv
mk
sr

french
arabic
persian
russian
chinese simplified
chinese traditional
spanish
hindi
portuguese
japanese
german
javanese
korean
turkish
vietnamese
italian
urdu
polish
ukrainian
romanian
azerbaijani
hausa
burmese
thai
dutch
yoruba
indonesian
swedish
norwegian
hebrew
danish
malay
filipino
finnish
czech
slovak
armenian
bulgarian
georgian
greek
croatian
hungarian
lithuanian
latvian
macedonian
serbian

Response

[
{
"airline":
{
"iataCode":"UA",
"icaoCode":"UAL",
"name":"United Airlines"
},
"arrival":
{
"actualRunway":null,
"actualTime":null,
"baggage":"7",
"delay":null,
"estimatedRunway":null,
"estimatedTime":"2022-11-03T10:02:00.000",
"gate":"107",
"iataCode":"EWR",
"icaoCode":"KEWR",
"scheduledTime":"2022-11-03T10:21:00.000",
"terminal":"C"
},
"codeshared":null,
"departure":
{
"actualRunway":"2022-11-03T06:12:00.000",
"actualTime":"2022-11-03T06:12:00.000",
"baggage":null,
"delay":"13",
"estimatedRunway":"2022-11-03T06:12:00.000",
"estimatedTime":"2022-11-03T06:10:00.000",
"gate":"34",
"iataCode":"IAH",
"icaoCode":"KIAH",
"scheduledTime":"2022-11-03T06:00:00.000",
"terminal":"C"
},
"flight":
{"iataNumber":"UA1268",
"icaoNumber":"UAL1268",
"number":"1268"
},
"status":"active",
"type":"departure"
},
…
]

Airline Routes

Request

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

For information about a specific route.
GET https://aviation-edge.com/v2/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 Airports and Cities

Request

For airports and cities nearby a certain latitude or longitude, within a certain distance.
GET https://aviation-edge.com/v2/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
}
]

Aviation Autocomplete

Request

Autocomplete based on cities alone
GET https://aviation-edge.com/v2/public/autocomplete?key=[API_KEY]&city=amsterdamOr
GET https://aviation-edge.com/v2/public/autocomplete?key=[API_KEY]&city=ams

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.

Historical Schedules

Request

For the departure schedule of a certain airport on a certain date.
GET https://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 https://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 https://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 https://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 https://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 https://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"
}
}

Future Schedules

Request

For the departure schedule of a certain airport on a certain future date.

GET https://aviation-edge.com/v2/public/flightsFuture?key=[API_KEY]&type=departure&iataCode=BER&date=YYYY-MM-DD

For the arrival schedule of a certain airport on a certain future date.
GET https://aviation-edge.com/v2/public/flightsFuture?key=[API_KEY]&type=arrival&iataCode=BER&date=YYYY-MM-DD

For the flights that are scheduled to arrive at a certain airport on a certain date (out of a departure schedule).
GET

https://aviation-edge.com/v2/public/flightsFuture?key=[API_KEY]&type=departure&iataCode=BER&arr_iataCode=ORY&date=YYYY-MM-DD

For the flights that are scheduled to depart from a certain airport on a certain date (out of an arrival schedule).
GET

https://aviation-edge.com/v2/public/flightsFuture?key=[API_KEY]&type=arrival&iataCode=BER&dep_iataCode=ory&date=YYYY-MM-DD

You can combine any type of the filters below to make specific calls. The below strings are all possible to use:

&iatacode=

&type=

&date=

&dep_iataCode=
&dep_icaoCode=

&arr_iataCode=

&arr_icaoCode=

&airline_iata=

&airline_icao=

&flight_num=

(obligatory) Airport IATA code
(obligatory) Either "departure" or "arrival" as both within the same query is not possible
(obligatory) Future date in YYYY-MM-DD format

filter of departure airport if "arrival" for "&type=" was chosen, based on the airport IATA code

filter of departure airport if "arrival" for "&type=" was chosen, based on the airport ICAO code

filter of arrival airport if "departure" for "&type=" was chosen, based on the airport IATA code

filter of arrival airport if "departure" for "&type=" was chosen, based on the airport ICAO code

option to filter airline based on airline IATA code

option to filter airline based on airline ICAO code

option to filter a specific flight based on its flight number

Response

[
{"weekday": "4",
"departure":
{"iataCode": "lax",
"icaoCode": "klax",
"terminal": "4",
"gate": "A",
"scheduledTime": "12:00"},
"arrival":
{"iataCode": "jfk",
"icaoCode": "kjfk",
"terminal": "8",
"gate": "B",
"scheduledTime": "20:35"
},
"aircraft":
{"modelCode": "a321",
"modelText": "airbus a321-231"
},
"airline":
{"name": "american airlines",
"iataCode": "aa",
"icaoCode": "aal"},
"flight":
{"number": "274",
"iataNumber": "aa274",
"icaoNumber": "aal274"}
},

(Example for a codeshared flight)

[
{"weekday": "4",
"departure":
{"iataCode": "sea",
"icaoCode": "ksea",
"terminal": "B", "gate": "21",
"scheduledTime": "14:07"
},
"arrival":
{"iataCode": "jfk",
"icaoCode": "kjfk",
"terminal": "7",
"gate": "1",
"scheduledTime": "22:29"
},
"aircraft":
{"modelCode": "a21n",
"modelText": "airbus a321-253n"},
"airline":
{"name": "Qatar Airways",
"iataCode": "qr",
"icaoCode": "qr"
},
"flight":
{"number": "2996",
"iataNumber": "qr2996",
"icaoNumber": "qr2996"
},
"codeshared":
{"airline":
{"name": "alaska airlines",
"iataCode": "as",
"icaoCode": "asa"},
"flight":
{"number": "426",
"iataNumber": "as426",
"icaoNumber": "asa426"}}
},

Satellite Tracker

Request

All on-orbit satellite information in one call:

GET https://aviation-edge.com/v2/public/satelliteDetails?key=[API_KEY]&limit=30000

Individual satellites based on NORAD number:
GET https://aviation-edge.com/v2/public/satelliteDetails?key=[API_KEY]&code=408

Satellites based on launch year:

GET

https://aviation-edge.com/v2/public/satelliteDetails?key=[API_KEY]&launchYear=1961

Individual satellites based on international designator (NSSDC ID) number:
GET https://aviation-edge.com/v2/public/satelliteDetails?key=[API_KEY]&intldes=1961-015EH

Filtering based on orbital apogee and perigee

GET https://aviation-edge.com/v2/public/satelliteDetails?key=[API_KEY]&orbitalapogee=1035

GET

https://aviation-edge.com/v2/public/satelliteDetails?key=[API_KEY]&orbitalperigee=939

Response

[
{
"code":408,
"country":"US",
"intldes":"1961-015EH",
"launchDate":"1961-06-29",
"launchNum":"15",
"launchPart":"EH",
"launchYear":"1961",
"name":"THOR ABLESTAR DEB",
"orbitalApogee":"1035",
"orbitalInclination":"66.79",
"orbitalPerigee":"929",
"orbitalPeriod":"104.73",
"result":{
"ECI":{
"posX":0.5454890369,
"posY":-0.2586148768,
"posZ":-0.9850851542,
"velX":0.0575062685,
"velY":0.0304486006,
"velZ":0.0232874073},
"geography":{
"alt":1006.4047009328,
"lat":-58.6467050931,
"lon":129.4707358377},
"satelliteInfo":{
"classification":"U",
"idLaunchNumber":"015",
"idLaunchPiece":"EH ",
"idLaunchYear":"61",
"orbit":99888,
"rightAscension":21.7828,
"satnumber":408}
},
"size":"MEDIUM",
"tle1":"1 408U 61015EH 20129.79820524 -.00000021 +00000-0 +54301-4 0 9997",
"tle2":"2 408 066.7883 021.7828 0070545 199.3274 220.5694 13.74946678998881",
"type":"DEBRIS",
"updated":1589063274000
}
]

Aviation Edge API for Developers

Flight Tracking

Request

Response

Flight Schedules and Timetables

Request

Translations

Response

Airline Routes

Request

Response

Nearby Airports and Cities

Request

Response

Aviation Autocomplete

Request

Response

Historical Schedules

Request

Response

Future Schedules

Request

Response

Satellite Tracker

Request

Response

Airport Database

Request

Response

Airline Database

Request

Response

Airplane Database

Request

Response

City Database

Request

Response

Country Database

Request

Response

Tax Codes Database

Response

Aircraft types Database

Response