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. |