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

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

Example API Request with parameter Departure Iata Code:

https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&departureIata=OTP

Example API Request with parameter Departure Icao Code:

https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&departureIcao=LROP

Example API Request with parameter Airline Iata Code:

https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&airlineIata=0B

Example API Request with parameter Airline Icao Code:

https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&airlineIcao=BMS

Example API Request with parameter Flight Number:

https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&flightNumber=101

Example API Request with parameter Arrival Iata Code:

https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&arrivalIata=WAW

Example API Request with parameter Arrival Icao Code:

https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&arrivalIcao=EPWA

Example API Request for information about a specific route:

https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&departureIata=OTP&departureIcao=LROP&airlineIata=0B&airlineIcao=BMS&flightNumber=101

HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
departureIata [Optional] Filter your results by departure city or airport using an IATA code. You can retrieve IATA codes using the Airports or Cities API endpoints. Example: OTP.
departureIcao [Optional] Filter your results by departure city or airport using an ICAO code. You can retrieve ICAO codes using the Airports or Cities API endpoints. Example: LROP.
arrivalIata [Optional] Filter your results by arrival city or airport using an IATA code. You can retrieve IATA codes using the Airports or Cities API endpoints. Example: WAW.
arrivalIcao [Optional] Filter your results by arrival airport using an ICAO code. You can retrieve ICAO codes using the Airports API endpoint. Example:EPWA.
airlineIata [Optional] Filter your results by airline IATA code. You can retrieve airline IATA codes using the Airlines API endpoint. Example:0B.
airlineIcao [Optional] Filter your results by airline ICAO code. You can retrieve airline IATA codes using the Airlines API endpoint. Example:BMS.
flightNumber [Optional] Filter your results by providing a flight number. Example: 101.

Example API Response:

                
                  {
                    "success": true,
                    "data": [
                        {
                          "airlineIata": "0B",
                          "airlineIcao": "BMS",
                          "arrivalIata": "TRN",
                          "arrivalIcao": "LIMF",
                          "arrivalTerminal": null,
                          "arrivalTime": "10:45:00",
                          "codeshares": null,
                          "departureIata": "OTP",
                          "departureIcao": "LROP",
                          "departureTerminal": null,
                          "departureTime": "09:15:00",
                          "flightNumber": "101",
                          "regNumber": [
                              "YR-BAP"
                          ]
                        },
                        { 
                          ... 
                        }
                    ]
                  }

API Response Objects:

Response Object Description
airlineIata Returns the Airline IATA code.
airlineIcao Returns the Airline ICAO code.
arrivalIata Returns the IATA code of the arrival location/airport.
arrivalIcao Returns the ICAO code of the arrival location/airport.
arrivalTerminal Returns the arrival terminal.
arrivalTime Returns the arrival time.
codeshares Returns the name of the code shares.
departureIata Returns the IATA code of the departure location/airport.
departureIcao Returns the ICAO code of the departure location/airport.
departureTerminal Returns the departure terminal.
departureTime Returns the departure time.
flightNumber Returns the flight number.
regNumber Returns the registration number.


Airports

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

Example API Request For the entire database of airports:

https://goflightlabs.com/airports?access_key=YOUR_ACCESS_KEY

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

https://goflightlabs.com/airports?access_key=YOUR_ACCESS_KEY&codeIataAirport=AAH

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

https://goflightlabs.com/airports?access_key=YOUR_ACCESS_KEY&codeIso2Country=DE

HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
codeIataAirport [Optional] 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:

                
                  {
                    "data": [
                      {
                        "GTM": "1",
                        "airportId": 7,
                        "codeIataAirport": "AAH",
                        "codeIataCity": "AAH",
                        "codeIcaoAirport": "EDKA",
                        "codeIso2Country": "DE",
                        "geonameId": "3207669",
                        "latitudeAirport": 50.75,
                        "longitudeAirport": 6.133333,
                        "nameAirport": "Aachen/Merzbruc",
                        "nameCountry": "Germany",
                        "phone": "",
                        "timezone": "Europe/Berlin"
                      },
                      [...]
                    ]
                  }

API Response Objects:

Response Object Description
GTM Returns the GMT offset in hours.
airportId Returns the full name of the airport.
codeIataAirport Returns the IATA code associated with the airport.
codeIataCity Returns the IATA code of the city the airport is in.
codeIcaoAirport Returns the ICAO code associated with the airport.
codeIso2Country Returns the ISO code country of the airport.
geonameId Returns the GeoNames ID of the airport.
latitudeAirport Returns the latitude coordinate associated with the airport location.
longitudeAirport Returns the longitude coordinate associated with the airport location.
nameAirport Returns the full name of the airport.
nameCountry Returns the name of the country the airport is in.
phone Returns the phone number of the airport.
timezone Returns the timezone the airport is in. Example: Europe/Berlin


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://app.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://app.goflightlabs.com/airlines?access_key=YOUR_ACCESS_KEY&codeIataAirline=AA

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

https://app.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 acccount 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": [
                        {
                          "ageFleet":	10.9,
                          "airlineId":	1,
                          "callsign":	"AMERICAN",
                          "codeHub":	"DFW",
                          "codeIataAirline":	"AA",
                          "codeIcaoAirline":	"AAL",
                          "codeIso2Country":	"US",
                          "founding":	1934,
                          "iataPrefixAccounting":	"1",
                          "nameAirline":	"American Airlines",
                          "nameCountry":	"United States",
                          "sizeAirline":	963,
                          "statusAirline":	"active",
                          "type":	"scheduled",
                        },
                        [...]
                    ]
                  }

API Response Objects:

Response Object Description
ageFleet Returns age fleet.
airlineId Returns the airline Id.
callsign Returns the call sign.
codeHub Returns the hub code associated with the airline.
callsign Returns the ICAO callsign of the airline.
codeIataAirline Returns the IATA code of airline.
codeIso2Country Returns the ISO2 code of Country.
founding Returns the founding year.
iataPrefixAccounting Returns the IATA code prefix accounting.
nameAirline Returns the name of airline.
nameCountry Returns the name of country.
sizeAirline Returns the size of airline.
statusAirline Returns the status of airline.
type Returns the type of airline.


Airplanes

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://app.goflightlabs.com/airplanes?access_key=YOUR_ACCESS_KEY&numberRegistration=HB-JVE

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

https://app.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://app.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 acccount dashboard.
numberRegistration [Requiered | Conditional] Use this parameter to get information about a specific airplane, you can search based on registration number.
hexIcaoAirplane [Requiered | Conditional] Use this parameter to get information about the airplanes based on the hex ICAO code.
codeIataAirline [Requiered | 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://app.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://app.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 acccount dashboard.
codeIataAircraft [Optional] Use this parameter to get ainformation 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://app.goflightlabs.com/taxes?access_key=YOUR_ACCESS_KEY

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

https://app.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 acccount 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://app.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 acccount 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

To look up destination cities, you can use the API's cities endpoint.

Example API Request for the entire database of city benchmark:

https://app.goflightlabs.com/cities?access_key=YOUR_ACCESS_KEY

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

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

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

https://app.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 acccount dashboard.
codeIataCity [Optional] Use this parameter to get information about a specific city benchmark information, you can search based on IATA code.
codeIso2Country [Optional] Use this parameter to get the city benchmark information based on the country code.

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.


Countries

To look up destination countries, you can use the API's countries endpoint.

Example API Request For the entire database of countries:

https://app.goflightlabs.com/countries?access_key=YOUR_ACCESS_KEY

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

https://app.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://app.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 acccount dashboard.
codeIso2Country [Optional] Use this parameter to get information about a specific country, you can search based on ISO code.
nameCountry [Optional] Use this parameter to get the country information based on the country name.

Example API Response:

                
                  {
                      "data": [
                        {
                          "countryId": "1",
                          "nameCountry": "Andorra",
                          "codeIso2Country": "AD",
                          "codeIso3Country": "AND",
                          "numericIso": "20", "population": "84000",
                          "capital": "Andorra la Vella",
                          "continent": "EU",
                          "nameCurrency": "Euro",
                          "codeCurrency": "EUR",
                          "codeFips": "AN",
                          "phonePrefix": "376"
                        },
                        [...]
                    ]
                  }

API Response Objects:

Response Object Description
countryId Returns the ID of the country.
nameCountry Returns the name of the country.
codeIso2Country Returns the 2-letter ISO code of the country.
codeIso3Country Returns the 3-letter ISO code of the country.
numericIso Returns the numeric ISO code of the country.
capital Returns the capital of the country.
continent Returns the continent the country is located in.
nameCurrency Returns the name of the currency associated with the country.
codeCurrency Returns the code of the currency associated with the country.
codeFips Returns the FIPS code of the country.
phonePrefix Returns the phone prefix associated with the country.
population Returns the population of the country.