Table of Contents

API Documentation

Aviyair Flight Data API is your user-friendly shortcut to getting global flight data that captures real-time and historical flight schedules and delays, and tracks commercial airlines operating live flights. The aviation data is your up-to-date right-hand tool that will streamline your flight project in an instant.

In this API documentation, you will find information about the structure of the API requests and responses in a JSON format. At the bottom, explanation about integration of the Aviyair Flight Data APIs in other programming languages is provided.

Access via API Key

When you subsribe to Aviyair’s flight data API, you automatically receive an API key in your account dashboard. Please, make sure to register so that you can enter the dashboard. Each account made on Aviyair is assigned only one API key that is unique. API keys are individual for our flight data users, which means that you cannot get somebody else’s API key.

Flight Tracker and Status API

Below you find examples of API requests with parameters, API reponses and a list of all key filtering parameters you can use in your data search via the API key.

Example: API Request with a Parameter
https://data.aviyair.com/data/v1/tracker?
key=[APIKEY]&limit=30&departure_iata=IAD
Example: API Response
				
					{
    "status": {
        "message": "Success"
    },
    "results": [
{
"aircraft":
{
"iataCode":""B77W"",
"icao24":4BA94E,
"icaoCode":"B77W",
"regNumber":"TC-JJN"
},
"airline":
{
"iataCode":"TK",
"icaoCode":"THY"
},
"arrival":
{
"iataCode":"IST",
"icaoCode":"LTBA"
},
"departure":
{"iataCode":"IAD",
"icaoCode":"KIAD"
},
"flight":
{
"iataNumber":"TK8",
"icaoNumber":"THY8",
"number":"8"
},
"geography":
{
"altitude":10668,
"direction":79,
"latitude":58.67,
"longitude":-44.16},
"speed":
{"horizontal":	937.112,
"isGround":0.0,
"vspeed":0.0
},
"status":"en-route",
"system":
{
"squawk":null,
"updated":1669878102
}

				
			
Get Request Parameters

depIata

Departure airport IATA code

depIcao

Departure airport ICAO code

arrIata

Arrival airport IATA code

arrIcao

Arrival airport ICAO code

aircraftIcao

Aircraft ICAO code

regNum

Aircraft registration number

aircraftIcao24

Aircraft ICAO24 code

airlineIata

Airline IATA code

airlineIcao

Airline ICAO code

flightIata

Flight IATA code

flightIcao

Flight ICAO code

flightNum

Flight number

status

Status of the flight (started, en-route, landed, unknown)
Limit value for output

limit

Limit value for output

lat=&lng=&distance

Flights within a specified circle based on the coordinates (distance is radius in km)

Global Flight Schedules API

Below you find examples of API requests with parameters, API reponses and a list of all key filtering parameters you can use in your data search via the API key.

Example: API Request with a Parameter
https://data.aviyair.com/data/v1/liveschedule
?key=[APIKEY]&airport_aita=IAD&type=departure&airline_iata=AA
Example: API Response
				
					{
"airline":
{
"iataCode":"AA",
"icaoCode":"AAL",
"name":"American Airlines"
},
"arrival":
{
"actualRunway":"2022-08-11T10:35:00.000",
"actualTime":"2022-08-11T10:35:00.000",
"baggage":4,
"delay":"6",
"estimatedRunway":"null",
"estimatedTime":"2022-11-30T21:44:00.000",
"gate":"C14",
"iataCode":"CLT",
"icaoCode":"KCLT",
"scheduledTime":"2022-11-30T21:26:00.000",
"terminal":"null"
},
"departure":
{
"actualRunway":"null",
"actualTime":"null",
"baggage":"null",
"delay": "null",
"estimatedRunway":"null",
"estimatedTime":"2022-12-01T06:49:00.000",
"gate":"B71",
"iataCode":"IAD",
"icaoCode":"KIAD",
"scheduledTime":"2022-12-01T06:49:00.000",
"terminal":"null"

},
"flight":
{
"iataNumber":"AA2617",
"icaoNumber":"AAL2617",
"number":"2617"
},
"status":"scheduled",
"type":"departure"
}

				
			

Historical Flight Schedules API

Below you find examples of API requests with parameters, API reponses and a list of all key filtering parameters you can use in your data search via the API key.

Example: API Request with a Parameter
https://data.aviyair.com/data/v1/historicalschedule?key=[APIKEY]&airport_aita=IAD&type
=departure&date_from=2022-05-24&airline_iata=AA
Example: API Response
				
					"departure":
{
"iataCode":"iad",
"icaoCode":"kiad",
"delay":"21",
"scheduledTime":"2022-05-23t20:40:00.000",
"estimatedTime":"2022-05-23t20:40:00.000",
"actualTime":"2022-05-23t21:00:00.000",
"estimatedRunway":"2022-05-23t21:00:00.000",
"actualRunway":"2022-05-23t21:00:00.000",
},
"arrival":
{
"iataCode":"doh",
"icaoCode":"othh",
"baggage":"3",
"scheduledTime":"2022-05-24t16:35:00.000",
"estimatedTime":"2022-05-24t16:24:00.000",
},
"airline":
{
"name":"american airlines"
"iataCode":"aa",
"icaoCode":"aal",

},
"flight":
"number":"8120"
"iataCode":"aa8120",
"icaoNumber":"aal8120",

"codeshared":
"name":"qatar airways"
"iataCode":"qr",
"icaoCode":"qtr",
},
"flight":
"number":"708"
"iataCode":"qr708",
"icaoCode":"qtr708",
} 
				
			

Future Flight Schedules API

Below you find examples of API requests with parameters, API reponses and a list of all key filtering parameters you can use in your data search via the API key.

Example: API Request with a Parameter
https://data.aviyair.com/data/v1/airlineroutes
?key=[APIKEY]&city=YXY
Example: API Response
				
					"weekday": "3", 
"departure": 
{
"iataCode": "iad", 
"icaoCode": "kiad", 
"terminal": "null", 
"gate": "b71", 
"scheduledTime": "07:00"
}, 
"arrival": 
{
"iataCode": "dfw", 
"icaoCode": "kdfw", 
"terminal": "c", 
"gate": "c16", 
"scheduledTime": "09:25"
}, 
"aircraft": 
{
"modelCode": "b738", 
"modelText": "boeing 737-823"
}, 
"airline": 
"name": "null", 
"iataCode": "as", 
"icaoCode": "as"
}, 
"flight": 
{
"number": "4518", 
"iataNumber": "as4518", 
"icaoNumber": "as4518"
}, 

"codeshared": 
{
"airline": 
{
"name": "american airways", 
"iataCode": "aa", 
"icaoCode": "aal"
}, 
"flight": 
{
"number": "2617", 
"iataNumber": "al2617", 
"icaoNumber": "aal2617"

}


				
			

Flight Delay Schedules API

Below you find examples of API requests with parameters, API reponses and a list of all key filtering parameters you can use in your data search via the API key.

Example: API Request with a Parameter
https://aviyair.com/api/v1/flightdelay
    ?key=[API-KEY]&arrivalterminal
Example: API Response
				
					{
"airline":
{
"iataCode":"AF",
"icaoCode":"AFR",
"name":"Air France"
},
"arrival":
{
"actualRunway":"2022-08-11T11:48:00.000",
"actualTime":"2022-08-11T11:48:00.000",
"baggage":"05",
"delay":null,
"estimatedRunway":"2022-08-11T11:48:00.000",
"estimatedTime":"2022-08-11T11:43:00.000",
"gate":"2",
"iataCode":"ORY",
"icaoCode":"LFPO",
"scheduledTime":"2022-08-11T12:00:00.000",
"terminal":"2"
},
"departure":

{
"actualRunway":"2022-08-11T10:35:00.000",
"actualTime":"2022-08-11T10:35:00.000",
"baggage":4,
"delay":"6",
"estimatedRunway":"2022-08-11T10:35:00.000",
"estimatedTime":"2022-08-11T10:30:00.000",
"gate":"2C",
"iataCode":"NCE",
"icaoCode":"LFMN",
"scheduledTime":"2022-08-11T10:30:00.000",
"terminal":"2"
},
"flight":
{
"iataNumber":"AF6209",
"icaoNumber":"AFR6209",
"number":"6209"
},
"status":"landed",
"type":"arrival"
} 
				
			

Airline Routes API

Below you find examples of API requests with parameters, API reponses and a list of all key filtering parameters you can use in your data search via the API key.

Example: API Request with a Parameter
https://data.aviyair.com/data/v1/airlineroutes
?key=[APIKEY]&city=YXY
Example: API Response
				
					{
"airlineIata":"4N",
"airlineIcao":"ANT",
"arrivalIata":"YDA",
"arrivalIcao":"CYDA",
"arrivalTerminal":"null",
"arrivalTime":"null",

"codeshares": "null"

"departureIata":"YXY",
"departureIcao":"CYXY",
"departureTerminal":"null",
"departureTime":"null",
"flightNumber":"2207",
"regNumber":"null"

},


{
"airlineIata":"4N",
"airlineIcao":"ANT",
"arrivalIata":"YVR",
"arrivalIcao":"CVYR",
"arrivalTerminal":"M",
"arrivalTime":"09:45:00",

"codeshares": "NULL"

"departureIata":"YXY",
"departureIcao":"CYXY",
"departureTerminal":"null",
"departureTime":"07:30:00",
"flightNumber":"505",
"regNumber":"null"

},

				
			

Airport and City Autocomplete Location API

Below you find examples of API requests with parameters, API reponses and a list of all key filtering parameters you can use in your data search via the API key.

Example: API Request with a Parameter
https://data.aviyair.com/data/v1/autocomplete
?key=[APIKEY]&city=avl
Example: API Response
				
					{
"GMT":"1",
"codeIataAirport":"QYU",
"codeIataCity":"GVX",
"codeIcaoAirport":"null",
"codeIso2Country":"SE",
"latitudeAirport":60.6746161,
"longitudeAirport":17.1418309,
"nameAirport":"Gavle C Railway Station",
"nameCountry":"Sweden",
"phone":"null,
"timezone":"Europe/Stockholm"
}
],

"GMT":"3",
"codeIataAirport":"IAR",
"codeIataCity":"IAR",
"codeIcaoAirport":"UUDL",
"codeIso2Country":"RU",
"latitudeAirport":57.61667,
"longitudeAirport":39.88333,
"nameAirport":"Yaroslavl",
"nameCountry":"Russia",
"phone":"null,
"timezone":"Europe/Moscow"
}