GET /flights
Real-time aircraft position, speed, flight details, status and more for live flights.
Request
- Base URLhttps://aviation-edge.com/v2/public
- AuthAPI key in query parameter key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Your Aviation Edge API key (sent to your email)
Departure airport IATA code <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>depIata</font></b>=MAD
Departure airport ICAO code <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>depIcao</font></b>=LFPG
Arrival airport IATA code <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>arrIata</font></b>=BER
Arrival airport ICAO code <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>arrIcao</font></b>=EDDB
Airline ICAO code <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>airlineIcao</font></b>=BOI
Aircraft ICAO code <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>aircraftIcao</font></b>=A124
Aircraft registration number <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>regNum</font></b>=N923SW
Aircraft ICAO 24-bit address <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>aircraftIcao24</font></b>=AC82EC
Airline IATA code <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>airlineIata</font></b>=W8
Flight number in IATA format <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>flightIata</font></b>=W8519
Flight number in ICAO format <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>flightIcao</font></b>=KLM641
Flight number without the airline code <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&airlineIata=W8&<b><font color=#eb9532>flightNum</font></b>=283
Status of the flight (can be started, en-route, landed, unknown) <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&arrIata=LHR&<b><font color=#eb9532>status</font></b>=en-route
Limit the number of flights returned in your request <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&arrIata=JFK&status=started&<b><font color=#eb9532>limit</font></b>=20
Latitude parameter to get flights within a specified circle based on the coordinates <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&<b><font color=#eb9532>lat</font></b>=51.5074&lng=0.1278&distance=100&arrIata=LHR
Longitude parameter to get flights within a specified circle based on the coordinates <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&lat=51.5074&<b><font color=#eb9532>lng</font></b>=0.1278&distance=100&arrIata=LHR
Flights within a specified circle based on the coordinates (distance is radius in km) <p><i>Example:</i> https://aviation-edge.com/v2/public/flights?key=[API_KEY]&lat=51.5074&lng=0.1278&<b><font color=#eb9532>distance</font></b>=100&arrIata=LHR
Response
Successful operation
Example response
{
"aircraft": {
"iataCode": "B789",
"icao24": "78160E",
"icaoCode": "B789",
"regNumber": "B-208X"
},
"airline": {
"iataCode": "FM",
"icaoCode": "CSH"
},
"arrival": {
"iataCode": "PVG",
"icaoCode": "ZSPD"
},
"departure": {
"iataCode": "MEL",
"icaoCode": "YMML"
},
"flight": {
"iataNumber": "MU740",
"icaoNumber": "CES740",
"number": "740"
},
"geography": {
"altitude": 7604.76,
"direction": 333.92,
"latitude": -36.5964,
"longitude": 143.667
},
"speed": {
"horizontal": 880.452,
"vspeed": 22.248
},
"status": "en-route",
"system": {
"squawk": 1247,
"updated": 1737027892
}
}Changes
No recorded changes to this operation across all 1 revision of this API.