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
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://app.goflightlabs.com/advanced-flights-schedules?access_key=YOUR_ACCESS_KEY
Example API Request For the departure schedule of a certain airport:
https://app.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-26T10: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-26T10: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-26T10: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-26T10: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-26T10: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-26T10: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-26T10: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-26T10: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. |