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.