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

departure_iata

Three-letter IATA code for departure airport 

departure_icao

Four-letter ICAO code for departure airport known as location indicator 

arrival_iata

Three-letter IATA code for arrival airport 

arrival_icao

Four-letter ICAO code for arrival airport known as location indicator 

aircraft_icao

ICAO code of the aircraft 

registration_number

Registration number of aircraft 

aircraft_icao24

ICAO24 code of the aircraft 

airline_iata

IATA code of an airline 

airline_icao

ICAO code of an airline 

flight_iata

IATA code of the flight 

flight_icao

ICAO code of the flight 

flight_number

Flight number

status

Flight status designated as (started, en-route, landed, unknown) For outputs limit the value

limit

 For outputs limit the value

&lat=&lng=&distance=

Flights falling in a specified circle based on the coordinates (distance is measured in 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"
}

				
			
Get Request Parameters

airport_iata

Three-letter IATA code for arrival airport 

type

Aircraft status as either depature or arrival

status

Flight status designated as (started, en-route, landed, unknown) For outputs limit the value

departure_iata

Three-letter IATA code for departure airport 

departure_icao

Four-letter ICAO code for departure airport known as location indicator 

departure_terminal

The terminal at which the departure is

departure_delay

Departure delay measured in minutes 

departure_sch_time

Scheduled departure of flight 

departure_est_time

Estimated time of departure of a fligth

departure_act_time

The actual time of departure of a flight

departure_est_runway

Estimated time of departure at runaway 

departure_act_runway

The actual time of departure at runaway 

arrival_iata

Three-letter IATA code for arrival airport 

arrival_icao

Four-letter ICAO code for arrival airport known as location indicator 

arrival_terminal

The terminal at which the arrival is 

arrival_delay

Arrival delay measured in minutes

arrival_sch_time

Scheduled arrival of flight 

arrival_est_time

Estimated time of arrival of a flight

arrival_act_time

The actual time of arrival of a flight 

arrival_est_runway

Estimated time of arrival at runaway

arrival_act_runway

The actual time of arrival at runaway

airline_name

The name of the airline 

airline_iata

IATA code of an airline

airline_icao

ICAO code of an airline 

flight_number

Flight number 

flight_iata

IATA code of the flight 

flight_icao

ICAO code of the flight 

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",
} 
				
			
Get Request Parameters

airport_iata

Three-letter IATA code for arrival airport 

type

Aircraft status as either depature or arrival

date_from

The start of the date range for which you search for flights 

date_to

The end of the date range for which you search for flights

departure_iata

Four-letter ICAO code for departure airport known as location indicator 

arrival_iata

Three-letter IATA code for arrival airport

airline_iata

IATA code of an airline

flight_number

Flight number 

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"

}


				
			
Get Request Parameters
airport_iata

Three-letter IATA code for arrival airport 

type

Aircraft status as either depature or arrival

date

The date on which you search for the flight

departure_iata

Three-letter IATA code for departure airport 

departure_icao

Four-letter ICAO code for departure airport known as location indicator 

 arrival_iata  Three-letter IATA code for arrival airport
 arrival_icao  Four-letter ICAO code for arrival airport known as location indicator
 airline_iata IATA code of an airline
 airline_icao  ICAO code of an airline
 flight_number  The number of the flight

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"
} 
				
			
Get Request Parameters

airport_iata

Three-letter IATA code for arrival airport 

type

Aircraft status as either depature or arrival

status

Flight status designated as (started, en-route, landed, unknown) For outputs limit the value

departure_iata

Three-letter IATA code for departure airport 

departure_icao

Four-letter ICAO code for departure airport known as location indicator 

departure_terminal

The terminal at which the departure is

departure_delay

Departure delay measured in minutes 

departure_sch_time

Scheduled departure of flight 

departure_est_time

Estimated time of departure of a fligth

departure_act_time

The actual time of departure of a flight

departure_est_runway

Estimated time of departure at runaway 

departure_act_runway

The actual time of departure at runaway 

arrival_iata

Three-letter IATA code for arrival airport 

arrival_icao

Four-letter ICAO code for arrival airport known as location indicator 

arrival_terminal

The terminal at which the arrival is 

arrival_delay

Arrival delay measured in minutes

arrival_sch_time

Scheduled arrival of flight 

arrival_est_time

Estimated time of arrival of a flight

arrival_act_time

The actual time of arrival of a flight 

arrival_est_runway

Estimated time of arrival at runaway

arrival_act_runway

The actual time of arrival at runaway

airline_name

The name of the airline 

airline_iata

IATA code of an airline

airline_icao

ICAO code of an airline 

flight_number

Flight number 

flight_iata

IATA code of the flight 

flight_icao

ICAO code of the flight 

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"

},

				
			
Get Request Parameters

airport_iata

Three-letter IATA code for airport 

airport_icao

Four-letter ICAO code for  airport known as location indicator 

airline_iata

IATA code of an airline 

airline_icao

ICAO code of the airline 

flight_number

Flight number 

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



				
			
Get Request Parameters

city

The name of the city for which you get autocomplete location data