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://goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY

Flight Schedules.


The API is capable of tracking flights and retrieving flight status information in real-time. In order to look up real-time information about one or multiple flights, you can use the API's flights endpoint together with optional parameters to filter your result set.

Example API Request For the departure schedule of a certain airport:

https://goflightlabs.com/advanced-flights-schedules?access_key=YOUR_ACCESS_KEY&iataCode=JFK&type=departure


HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
iataCode [Required] The IATA code of the airport you'd like to request data from.
type [Required] Flight type: departure or arrival
status [Optional] The status of the flight: landed, scheduled, cancelled, active, incident, diverted, redirected, unknown.
dep_iataCode [Optional] The IATA code of the departure airport (JFK, AMS, CDG, etc).
dep_icaoCode [Optional] The ICAO code of the departure airport (KJFK, EHAM, LFPG, etc).
dep_terminal [Optional] The terminal at the departure airport (1, 2, 3, 4, etc).
dep_delay [Optional] The delay in minutes at departure (10, 20, 45, etc) it is not possible to set a delay range.
dep_schTime [Optional] The scheduled flight's departure in the following format: YYYY-MM-DDT00:00:00.000 For example: 2024-02-25T08:00:00.000
dep_actTime [Optional] The actual flight departure time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2024-02-25T08:00:00.000
dep_estRunway [Optional] The estimated departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2024-02-25T08:00:00.000
dep_actRunway [Optional] The actual departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2024-02-25T08:00:00.000
arr_iataCode [Optional] The IATA code of the arrival airport (JFK, AMS, CDG, etc).
arr_icaoCode [Optional] The ICAO code of the arrival airport (KJFK, EHAM, LFPG, etc).
arr_terminal [Optional] The terminal at the arrival airport (1, 2, 3, 4, etc)
arr_delay [Optional] The delay in minutes at arrival (10, 20, 45, etc) it is not possible to set a delay range
arr_schTime [Optional] The scheduled flight's arrival in the following format: YYYY-MM-DDT00:00:00.000 For example: 2024-02-25T08:00:00.000
arr_estTime [Optional] The actual flight arrival time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2024-02-25T08:00:00.000
arr_estRunway [Optional] The estimated arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2024-02-25T08:00:00.000
arr_estRunway [Optional] The actual arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2024-02-25T08:00:00.000
airline_name [Optional] Name of the airline (Air France, American Airlines, Delta Air Lines, etc) (may need air%20france, american%20airlines, delta%20air%20lines is the response has problems)
airline_iata [Optional] IATA code of airline
airline_icao [Optional] ICAO code of airline
flight_num [Optional] The flight number based on 1 to 4 digits, for example: 171
flight_iata [Optional] The flight iata number consisting of digits and letters, usually of the airline iata code. For example: AA171
flight_icao [Optional] The flight icao number consisting of digits and letters, usually the airline icao code. For example: AAL171
codeshared [Optional] If the flight is codeshared, this data will be included. If you don't want codeshared flights, you can input null

Example API Response:

                        
                            {
                                "success": true,
                                "data": 
                                [
                                {
                                    "airline": {
                                        "iataCode": "TV",
                                        "icaoCode": "TBA",
                                        "name": "Tibet Airlines"
                                    },
                                    "arrival": {
                                        "actualRunway": null,
                                        "actualTime": null,
                                        "baggage": null,
                                        "delay": null,
                                        "estimatedRunway": null,
                                        "estimatedTime": "2022-11-07T16:17:00.000",
                                        "gate": null,
                                        "iataCode": "HJJ",
                                        "icaoCode": "ZGCJ",
                                        "scheduledTime": "2022-11-07T16:35:00.000",
                                        "terminal": "3"
                                    },
                                    "codeshared": {
                                        "airline": {
                                            "iataCode": "gj",
                                            "icaoCode": "cdc",
                                            "name": "loong air"
                                        },
                                        "flight": {
                                            "iataNumber": "gj8802",
                                            "icaoNumber": "cdc8802",
                                            "number": "8802"
                                        }
                                    },
                                    "departure": {
                                        "actualRunway": "2022-11-07T14:51:00.000",
                                        "actualTime": "2022-11-07T14:51:00.000",
                                        "baggage": null,
                                        "delay": "1",
                                        "estimatedRunway": "2022-11-07T14:51:00.000",
                                        "estimatedTime": "2022-11-07T14:52:00.000",
                                        "gate": "6",
                                        "iataCode": "LJG",
                                        "icaoCode": "ZPLJ",
                                        "scheduledTime": "2022-11-07T14:50:00.000",
                                        "terminal": null
                                    },
                                    "flight": {
                                        "iataNumber": "TV7104",
                                        "icaoNumber": "TBA7104",
                                        "number": "7104"
                                    },
                                    "status": "active",
                                    "type": "arrival"
                                },
                                [{...}]
                                ]
                            }
                        
                    

API Response Objects:

Response Object Description
airline > iataCode Returns The IATA code of the airline.
airline > icaoCode Returns The ICAO code of the airline.
airline > name Returns The NAME of the airline.
arrival > actualRunway Returns The actual arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000.
arrival > actualTime Returns The actual time in the following format: YYYY-MM-DDT00:00:00.000.
arrival > baggage Returns The baggage.
arrival > delay Returns The delay.
arrival > estimatedRunway Returns The estimated arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000.
arrival > estimatedTime Returns The estimated arrival time in the following format: YYYY-MM-DDT00:00:00.000.
arrival > gate Returns The gate.
arrival > iataCode Returns The IATA CODE.
arrival > icaoCode Returns The ICAO CODE.
arrival > scheduledTime Returns The Scheduled Time.
arrival > terminal Returns The terminal.
codeshared > airline > airline Returns The IATA Code airline.
codeshared > airline > icaoCode Returns The ICAO Code airline.
codeshared > airline > name Returns The Name.
codeshared > flight > iataNumber Returns The IATA Code of flight.
codeshared > flight > icaoNumber Returns The ICAO Code of flight.
codeshared > flight > number Returns The number of flight.
departure > actualRunway Returns The actual departure time at runway in the following format: YYYY-MM-DDT00:00:00.000.
departure > actualTime Returns The actual time in the following format: YYYY-MM-DDT00:00:00.000.
departure > baggage Returns The baggage.
departure > delay Returns The delay.
departure > estimatedRunway Returns The estimated departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 .
departure > estimatedTime Returns The estimated departure time in the following format: YYYY-MM-DDT00:00:00.000.
departure > gate Returns The gate.
departure > iataCode Returns The IATA code of departure.
departure > icaoCode Returns The ICAO code of departure.
departure > scheduledTime Returns The Scheduled Time of departure.
departure > terminal Returns The terminal.
flight > iataNumber Returns The IATA number of flight.
flight > icaoNumber Returns The ICAO number of flight.
flight > number Returns The flight number.
status Returns The flight status.
type Returns The flight type.