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:

https://goflightlabs.com/advanced-flights-schedules?access_key=YOUR_ACCESS_KEY

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 [Optional] The IATA code of the airport you'd like to request data from.
type [Optional] 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: 2023-09-22T08:00:00.000
dep_actTime [Optional] The actual flight departure time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-09-22T08:00:00.000
dep_estRunway [Optional] The estimated departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-09-22T08:00:00.000
dep_actRunway [Optional] The actual departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-09-22T08: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: 2023-09-22T08:00:00.000
arr_estTime [Optional] The actual flight arrival time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-09-22T08:00:00.000
arr_estRunway [Optional] The estimated arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-09-22T08:00:00.000
arr_estRunway [Optional] The actual arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-09-22T08: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.