FlightLabs API - Airports Documentation

Airline Routes

The API is capable of providing data about airline routes, updated every 24 hours. In order to get airline route data, use the API's routes endpoint along with a series of optional parameters to filter results.

Example API Request:

https://www.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&dep_iata=LAX

HTTP GET Request Parameters:

Parameter Description
dep_iata required Filtering by departure Airport IATA code.
dep_icao required Filtering by departure Airport ICAO code.
arr_iata required Filtering by arrival Airport IATA code.
arr_icao required Filtering by arrival Airport ICAO code.
airline_icao required Filtering by Airline ICAO code.
airline_iata required Filtering by Airline IATA code.
flight_icao optional Filtering by Flight ICAO code-number.
flight_iata optional Filtering by Flight IATA code-number.
flight_number optional Filtering by Flight number only.
_fields optional Fields to return (comma separated, e.g.: airline_iata,flight_number)
limit optional The maximum number of rows is 500.
offset optional Pagination offset for use with result limits (0+ until request.has_more)

Example API Response:

                
                {
                  "success": true,
                  "data": [
                    {
                      "airline_iata": "AA",
                      "airline_icao": "AAL",
                      "flight_number": "3206",
                      "flight_iata": "AA3206",
                      "flight_icao": "AAL3206",
                      "cs_airline_iata": "OO",
                      "cs_flight_iata": "OO3206",
                      "cs_flight_number": "3206",
                      "dep_iata": "LAX",
                      "dep_icao": "KLAX",
                      "dep_terminals": [
                        "5"
                      ],
                      "dep_time": "15:34",
                      "dep_time_utc": "23:34",
                      "arr_iata": "ABQ",
                      "arr_icao": "KABQ",
                      "arr_terminals": null,
                      "arr_time": "18:25",
                      "arr_time_utc": "01:25",
                      "duration": 111,
                      "aircraft_icao": null,
                      "counter": 1545,
                      "updated": "2024-03-09T16:58:51.000Z",
                      "days": [
                        "fri",
                        "sat",
                        "thu",
                        "tue",
                        "wed"
                      ]
                      },
                    { ... },
                  ]
                }

API Response Objects:

Response Object Description
airline_iata Airline IATA code.
airline_icao Airline ICAO code.
flight_number Flight number only.
flight_iata Flight IATA code-number.
flight_icao Flight ICAO code-number.
cs_airline_iata Codeshared airline IATA code.
cs_flight_iata Codeshared flight IATA code-number.
cs_flight_number Codeshared flight number.
dep_iata Departure airport IATA code.
dep_icao Departure airport ICAO code.
dep_terminals Estimated departure terminals.
dep_time Departure time in the airport time zone.
dep_time_utc Departure time in UTC time zone.
arr_iata Arrival airport IATA code.
arr_icao Arrival airport ICAO code.
arr_terminals Estimated arrival terminals.
arr_time Arrival time in the airport time zone.
arr_time_utc Arrival time in UTC time zone.
duration Estimated flight time (in minutes).
aircraft_icao Aircraft ICAO type.
counter A numerical counter.
updated Timestamp of the last update.
days List of days when the flight operates (e.g., ["fri", "sat"]).


Airports

API request example For information about a specific airport, you can search based on IATA code.

https://www.goflightlabs.com/airports?access_key=YOUR_ACCESS_KEY&codeIso2Country=US&codeIataAirport=LAX

API request example For the airports based on the country code.

https://www.goflightlabs.com/airports?access_key=YOUR_ACCESS_KEY&codeIso2Country=US&codeIataAirport=LAX

HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your account dashboard.
codeIataAirport [Required] Use this parameter to get information about a specific airport, you can search based on IATA code.
codeIso2Country [Optional] Use this parameter to get airports based on the country ISO code. Example: DE, US, ES.

Example API Response:

                
                {
                  "success": true,
                  "data": [
                    {
                      "name": "Aachen-Merzbrueck Airport",
                      "iata_code": "AAH",
                      "icao_code": "EDKA",
                      "faa_code": null,
                      "un_locode": "DEAAH",
                      "timezone": "Europe/Berlin",
                      "lat": 50.82345,
                      "lng": 6.18844,
                      "alt": 639,
                      "city_code": "ZEA",
                      "city": "Aachen",
                      "country_code": "DE",
                      "departures_intl": null,
                      "departures_dom": null,
                      "connections_intl": null,
                      "connections_dom": null,
                      "is_major": null,
                      "is_international": null,
                      "runways": 2,
                      "connections": null,
                      "departures": null,
                      "website": "https://www.flugplatz-aachen.de",
                      "twitter": null,
                      "facebook": null,
                      "instagram": null,
                      "linkedin": null,
                      "youtube": null,
                      "phone": null,
                      "phone_formatted": null,
                      "email": null,
                      "postal_code": null,
                      "with_schedules": null,
                      "type": "airport",
                      "fir_code": "EDGG",
                      "fir_name": "LANGEN",
                      "size": "small",
                      "status": "active",
                      "popularity": 10,
                      "distance": 54.676
                    }
                  ]
                }

API Response Objects:

Response Object Description
name Name of the airport
iata_code IATA code of the airport
icao_code ICAO code of the airport
faa_code FAA code of the airport (if available)
un_locode UN/LOCODE of the airport
timezone Timezone of the airport
lat Latitude of the airport
lng Longitude of the airport
alt Altitude of the airport (meters)
city_code City code where the airport is located
city City where the airport is located
country_code Country code where the airport is located
departures_intl International departures from the airport
departures_dom Domestic departures from the airport
connections_intl International connections from the airport
connections_dom Domestic connections from the airport
is_major Indicates if the airport is a major one
is_international Indicates if the airport is an international one
runways Number of runways at the airport
connections Number of total connections
departures Number of total departures
website Website of the airport
twitter Twitter handle of the airport (if available)
facebook Facebook page of the airport (if available)
instagram Instagram handle of the airport (if available)
linkedin LinkedIn page of the airport (if available)
youtube YouTube channel of the airport (if available)
phone Contact phone number of the airport
phone_formatted Formatted contact phone number of the airport
email Contact email address of the airport
postal_code Postal code of the airport
with_schedules Indicates if the airport has schedules available
type Type of the airport (e.g., "airport")
fir_code FIR code of the airport
fir_name Name of the Flight Information Region (FIR)
size Size of the airport (e.g., "small")
status Status of the airport (e.g., "active")
popularity Popularity rank of the airport
distance Distance from the reference point (e.g., in kilometers)


Airlines

To get data about global airlines, you can use the API's airlines endpoint.

Example API Request For the entire database of airlines:

https://www.goflightlabs.com/airlines?access_key=YOUR_ACCESS_KEY

API request example for information about a specific airline, you can search based on IATA airline code

https://www.goflightlabs.com/airlines?access_key=YOUR_ACCESS_KEY&codeIataAirline=AA

API request example for the airlines based on the country codes. 

https://www.goflightlabs.com/airlines?access_key=YOUR_ACCESS_KEY&codeIso2Country=US

HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your account dashboard.
codeIataAirline [Optional] Use this parameter to get information about a specific airline, you can search based on IATA airline code.
codeIso2Country [Optional] Use this parameter to get information the airlines based on the country codes.

Example API Response:

                
                {
                  "success": true,
                  "data": [
                    {
                      "name": "American Airlines",
                      "country_code": "US",
                      "iata_code": "AA",
                      "iata_prefix": 1,
                      "iata_accounting": 1,
                      "icao_code": "AAL",
                      "callsign": "AMERICAN",
                      "is_international": 1,
                      "iosa_registered": 1,
                      "iosa_expiry": "2025-07-28T22:00:00.000Z",
                      "is_passenger": 1,
                      "is_cargo": 1,
                      "is_scheduled": 1,
                      "total_aircrafts": 684,
                      "average_fleet_age": 10.2,
                      "accidents_last_5y": 26,
                      "crashes_last_5y": 0,
                      "website": "www.aa.com",
                      "twitter": "twitter.com/americanair",
                      "facebook": "facebook.com/aa",
                      "instagram": "instagram.com/americanair",
                      "linkedin": "linkedin.com/company/american-airlines"
                    }
                  ]
                }

API Response Objects:

Response Object Description
name Name of the airline
country_code Country code of the airline
iata_code IATA code of the airline
iata_prefix IATA prefix
iata_accounting IATA accounting code
icao_code ICAO code of the airline
callsign Callsign of the airline
is_international Indicates if the airline is international (1 for yes, 0 for no)
iosa_registered Indicates if the airline is registered with IOSA (1 for yes, 0 for no)
iosa_expiry Expiry date of IOSA registration
is_passenger Indicates if the airline operates passenger flights (1 for yes, 0 for no)
is_cargo Indicates if the airline operates cargo flights (1 for yes, 0 for no)
is_scheduled Indicates if the airline operates scheduled flights (1 for yes, 0 for no)
total_aircrafts Total number of aircraft operated by the airline
average_fleet_age Average age of the fleet in years
accidents_last_5y Number of accidents in the last 5 years
crashes_last_5y Number of crashes in the last 5 years
website Website of the airline
twitter Twitter handle of the airline
facebook Facebook page of the airline
instagram Instagram handle of the airline
linkedin LinkedIn page of the airline


Airplanes (DEPRECATED)

To get data about different airplanes/aircrafts, you can use the API's airplanes endpoint.

Example API Request For information about a specific airplane, you can search based on registration number:

https://www.goflightlabs.com/airplanes?access_key=YOUR_ACCESS_KEY&numberRegistration=HB-JVE

Example API Request For the airplanes based on the hex ICAO code:

https://www.goflightlabs.com/airplanes?access_key=YOUR_ACCESS_KEY&hexIcaoAirplane=4B19EA

Example API Request For information about airplanes of a specific airline, you can search based on airline IATA code:

https://www.goflightlabs.com/airplanes?access_key=YOUR_ACCESS_KEY&codeIataAirline=0B

HTTP GET Request Parameters:

Conditional: This endpoint always requires a parameter such as numberRegistration, hexIcaoAirplane or codeIataAirline.
They are not combinable and one of them is always required.
Object Description
access_key [Required] Your API access key, which can be found in your account dashboard.
numberRegistration [Required | Conditional] Use this parameter to get information about a specific airplane, you can search based on registration number.
hexIcaoAirplane [Required | Conditional] Use this parameter to get information about the airplanes based on the hex ICAO code.
codeIataAirline [Required | Conditional] Use this parameter to get information about airplanes of a specific airline, you can search based on airline IATA code.

Example API Response:

                
                  {
                    "success": true,
                    "data": [
                        {
                          airplaneIataType:	"F28 MK0100"
                          airplaneId:	55
                          codeIataAirline:	"2L"
                          codeIataPlaneLong:	"F100"
                          codeIataPlaneShort:	"100"
                          codeIcaoAirline:	""
                          constructionNumber:	"11459"
                          deliveryDate:	"1993-06-29T22:00:00.000Z"
                          enginesCount:	"2"
                          enginesType:	"JET"
                          firstFlight:	"1993-05-31T22:00:00.000Z"
                          hexIcaoAirplane:	"4B19EA"
                          lineNumber:	""
                          modelCode:	"F100"
                          numberRegistration:	"HB-JVE"
                          numberTestRgistration:	"PH-EZD"
                          planeAge:	"24"
                          planeClass:	"1"
                          planeModel:	"F-100"
                          planeOwner:	""
                          planeSeries:	""
                          planeStatus:	"active"
                          productionLine:	"Fokker 28/70/100"
                          registrationDate:	"2004-05-11T22:00:00.000Z"
                          rolloutDate:	"0000-00-00"
                        },
                        
                    ]
                  }

API Response Objects:

Response Object Description
airplaneId Returns the ID of the airplane.
numberRegistration Returns the registration number of the airplane.
productionLine Returns the production line identifier of the airplane.
airplaneIataType Returns the IATA type of the airplane.
planeModel Returns the model name of the airplane.
modelCode Returns the model code of the airplane.
hexIcaoAirplane Returns the HEX ICAO code of the airplane.
codeIataPlaneShort Returns the short IATA code of the airplane.
codeIataPlaneLong Returns the long IATA code of the airplane.
constructionNumber Returns the construction number of the airplane.
numberTestRgistration Returns the test registration number of the airplane.
rolloutDate Returns the rollout date of the airplane.
firstFlight Returns the first flight date of the airplane.
deliveryDate Returns the initial delivery date of the airplane.
registrationDate Returns the initial registration date of the airplane.
lineNumber Returns the production line number of the airplane.
codeIataAirline Returns the IATA code of the airplane.
codeIcaoAirline Returns the ICAO code of the airplane.
planeOwner Returns the owner name of the airplane.
enginesCount Returns the number of engines on the airplane.
enginesType Returns the type of engines on the airplane.
planeAge Returns the age of the airplane in years.
planeStatus Returns the current status of the airplane.


Aircraft Types

To get data about different aircraft types, you can use the API's aircraft_types endpoint.

Example API Request For the entire database of Aircraft types.:

https://www.goflightlabs.com/aircraft_types?access_key=YOUR_ACCESS_KEY

API request example with For information about a specific Aircraft type, input the IATA code.

https://www.goflightlabs.com/aircraft_types?access_key=YOUR_ACCESS_KEY&codeIataAircraft=100

HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your account dashboard.
codeIataAircraft [Required] Use this parameter to get a information about a specific Aircraft type, input the IATA code.

Example API Response:

                
                  {
                    "success": true,
                    "data": [
                        {
                          "planeTypeId": "100",
                          "nameAircraft": "Boeing 767-200 Freighter",
                          "codeIataAircraft": "76X" 
                        },
                        [...]
                    ]
                  }

API Response Objects:

Response Object Description
planeTypeId Returns the aircraft type ID.
nameAircraft Returns the aircraft name associated with the aircraft type.
codeIataAircraft Returns the IATA code associated with the aircraft type.


Aviation Taxes

To get data about aviation taxes, you can use the API's taxes endpoint.

Example API Request:

https://www.goflightlabs.com/taxes?access_key=YOUR_ACCESS_KEY

API request example with information about a specific tax code, input the IATA tax code.

https://www.goflightlabs.com/taxes?access_key=YOUR_ACCESS_KEY&codeIataTax=AC

HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your account dashboard.
codeIataTax [Optional] Use this parameter to get information about a specific tax code, input the IATA tax code.

Example API Response:

                
                  {
                    "data": [
                              {
                                "taxId": "1",
                                "nameTax": "Government Tax",
                                "codeIataTax": "AB"
                              },
                              [...]
                          ]
                  }

API Response Objects:

Response Object Description
taxId Returns the ID of tax.
nameTax Returns the name of the aviation tax.
codeIataTax Returns the IATA code associated with the aviation tax.


Autocomplete Cities

To look up destination cities, autocomplete based on cities alone.

Example API Request:

https://www.goflightlabs.com/autocomplete-cities?access_key=YOUR_ACCESS_KEY&city=amsterdam

HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your account dashboard.
city [Required] Autocomplete based on cities alone, example: amsterdam, ams.

Example API Response:

                
                  {
                    "success": true,
                    "data": [
                        {
                          "cityId": "1",
                          "nameCity": "Anaa",
                          "codeIataCity": "AAA",
                          "codeIso2Country": "PF",
                          "latitudeCity": "-17.05",
                          "longitudeCity": "-145.41667",
                          "timezone": "Pacific/Tahiti",
                          "GMT": "-10",
                          "geonameId": "0"
                        },
                        [...]
                    ]
                  }

API Response Objects:

Response Object Description
cityId Returns the ID of the city.
nameCity Returns the name of the city.
codeIataCity Returns the IATA code of the city.
codeIso2Country Returns the 2-letter ISO code of the city.
latitudeCity Returns the latitude coordinate associated with the city.
longitudeCity Returns the longitude coordinate associated with the city.
timezone Returns the timezone the city is in.
GMT Returns the GMT offset in hours.
geonameId Returns the GeoName ID associated with the city.


Cities

API request example For information about a specific city benchmark information, you can search based on IATA code. 

https://www.goflightlabs.com/cities?access_key=YOUR_ACCESS_KEY&codeIataCity=AAA

API request example For the city benchmark information based on the country code.

https://www.goflightlabs.com/cities?access_key=YOUR_ACCESS_KEY&codeIso2Country=PF

HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your account dashboard.
codeIataCity [Required] Use this parameter to get information about a specific city benchmark information, you can search based on IATA code.
codeIso2Country [Required] Use this parameter to get the city benchmark information based on the country code.

Example API Response:

                
                {
                  "success": true,
                  "data": [
                    {
                      "city_code": "AAA",
                      "un_locode": null,
                      "name": "Anaa",
                      "names": {
                      "en": "Anaa",
                      "az": "Anaa",
                      "ar": "أنا",
                      "de": "Anaa",
                      "id": "Anaa",
                      "jp": "アナー島",
                      "ko": "Anaa",
                      "pl": "Anaa",
                      "ru": "Анаа",
                      "ms": "Anaa",
                      "th": "อาน่า",
                      "pt": "Anaa",
                      "tr": "Anaa",
                      "vi": "Anaa",
                      "uk": "Анаа",
                      "tl": "Anaa"
                    },
                      "lat": -17.05,
                      "lng": -145.41667,
                      "alt": 75,
                      "country_code": "PF",
                      "timezone": "Pacific/Tahiti",
                      "wikipedia": null,
                      "population": null,
                      "popularity": 0,
                      "type": "city"
                    }
                  ]
                }

API Response Objects:

Response Object Description
city_code Returns the city code of the city.
un_locode Returns the UN Location Code of the city.
name Returns the name of the city.
names Returns the localized names of the city in different languages.
lat Returns the latitude of the city.
lng Returns the longitude of the city.
alt Returns the altitude of the city (in meters).
country_code Returns the country code of the city.
timezone Returns the timezone of the city.
wikipedia Returns the Wikipedia page of the city.
population Returns the population of the city.
popularity Returns the popularity score of the city.
type Returns the type of location (e.g., city, airport).


Countries

API request example with search parameter for information about a specific country, you can search based on ISO code:

https://www.goflightlabs.com/countries?access_key=YOUR_ACCESS_KEY&codeIso2Country=AD

API request example with search parameter for For the country information based on the country name:

https://www.goflightlabs.com/countries?access_key=YOUR_ACCESS_KEY&nameCountry=Andorra

HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your account dashboard.
codeIso2Country [Required] Use this parameter to get information about a specific country, you can search based on ISO code.
nameCountry [Required] Use this parameter to get the country information based on the country name.

Example API Response:

                
                  {
                      "data": [
                        {
                          "code": "US",
                          "code3": "USA",
                          "name": "United States",
                          "population": 327167434,
                          "continent": "NA",
                          "currency": "USD",
                          "names": {
                            "sk": "Spojené štáty",
                            "fa": "ایالات متحدهٔ امریکا",
                            "tr": "Amerika Birleşik Devletleri",
                            "hy": "Ամէրիկայի Միացյալ Նահանգնէր",
                            "lv": "United States",
                            "nl": "VS",
                            "hr": "Sjedinjene Države",
                            "it": "USA",
                            "sl": "Združene države Amerike",
                            "ar": "الاولايات المتحدة الامريكية",
                            "cs": "Spojené státy",
                            "nn": "USA",
                            "ku": "Dewletên Yekbûyî yên Amerîkayê",
                          }
                        }
                        [...]
                    ]
                  }

API Response Objects:

Response Object Description
code Returns the two-letter country code.
code3 Returns the three-letter country code.
name Returns the name of the country.
population Returns the population of the country.
continent Returns the continent code of the country.
currency Returns the currency code of the country.
names Returns the localized names of the country in different languages.
timezone Returns the timezone of the country.
© Copyright 2022-2025 | All rights reserved | 🧑‍🚀 Made remotely with ❤️ by Zyla Labs