The Flight Labs API was built to provide a simple way of accessing global aviation data for real-time and historical flights as well as allow customers to tap into an extensive data set of airline routes and other up-to-date aviation-related information.
Quickstart
Requests to the REST API are made using a straightforward HTTP GET URL structure and responses are provided in lightweight JSON format.
Example API Request:
https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY
Historical Flights
Apart from providing data about real-time flight, the API's flights endpoint is also capable of looking up data about historical flights.
Example API Request For the departure schedule of a certain airport on a certain date:
https://app.goflightlabs.com/historical/2023-08-27?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure
Example API Request For the arrival schedule of a certain airport on a certain date:
https://app.goflightlabs.com/historical/2023-08-27?access_key=YOUR_ACCESS_KEY&code=JFK&type=arrival
Example API Request For the schedule of a certain airport of a certain date range (also available for arrival):
https://app.goflightlabs.com/historical/2023-08-27?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-08-30
Example API Request For the schedule of a certain airport on a certain date (or range) but only flights with a certain status:
https://app.goflightlabs.com/historical/2023-08-27?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-08-30&status=cancelled
Example API Request For tracking individual historical flights:
https://app.goflightlabs.com/historical/2023-08-27?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-08-30&flight_number=5703
Example API Request 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):
https://app.goflightlabs.com/historical/2023-08-27?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-08-30&airline_iata=AY
HTTP GET Request Parameters:
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.
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
code |
[Required] Departure or arrival airport IATA code. |
type |
[Required] Either "departure" or "arrival" as both within the same query is not possible. |
date_to |
[Optional] Filter your results by end date of the requested date range. |
dep_iataCode |
[Optional] Filter by departure airport if "arrival" for "&type=" was chosen, based on the airport IATA code. |
arr_iataCode |
[Optional] Filter your results by arrival airport if "departure" for "&type=" was chosen, based on the airport IATA code. |
airline_iata |
[Optional] Option to filter airline based on airline IATA code |
flight_num |
[Optional] Option to filter a specific flight based on its flight number. Example: 5703 |
Example API Response:
{
"data": [
{
"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"
}
}
},
[...]
]
}
API Response Objects:
Response Object | Description |
---|---|
type |
Returns the type flight |
status |
Returns the flight status. Possible values: active (for departure schedules only), landed (for arrival schedules only), cancelled , unknown . |
departure > iata_code |
Returns the IATA code of the departure airport. |
departure > icao_code |
Returns the ICAO code of the departure airport. |
departure > scheduled_time |
Returns the scheduled time. |
arrival > iata_code |
Returns the IATA code of the arrival airport. |
arrival > icao_code |
Returns the ICAO code of the arrival airport. |
arrival > terminal |
Returns the terminal of the arrival airport. |
arrival > scheduled_time |
Returns the scheduled time. |
airline > name |
Returns the airline name. |
airline > iata_code |
Returns the airline IATA code. |
airline > icao_code |
Returns the airline ICAO code. |
flight > number |
Returns the flight number. |
flight > iata_number |
Returns the flight IATA number. |
flight > icao_number |
Returns the flight ICAO number. |
codeshared > airline > name |
Returns the airline name. |
codeshared > airline > iata_code |
Returns the airline IATA code. |
codeshared > airline > icao_code |
Returns the airline ICAO code. |
codeshared > flight > number |
Returns the flight number. |
codeshared > flight > iata_number |
Returns the flight IATA number. |
codeshared > flight > icao_number |
Returns the flight ICAO number. |