FlightLabs - Documentation - Real-Time Flights

API Documentation

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

To connect to the API, you can click the "run" button to run the show API request.

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

API Endpoints

Real-Time Flights

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/flights?access_key=YOUR_ACCESS_KEY

Example API Request with parameters:

https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&flight_status=active

HTTP GET Request Parameters:

Object	Description
`access_key`	[Required] Your API access key, which can be found in your acccount dashboard.
`flight_status`	[Optional] Filter your results by flight status. Available values: scheduled, active, landed, cancelled, incident, diverted
`dep_iata`	[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.
`arr_iata`	[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.
`dep_icao`	[Optional] Filter your results by departure airport using an ICAO code. You can retrieve ICAO codes using the Airports API endpoint.
`arr_icao`	[Optional] Filter your results by arrival airport using an ICAO code. You can retrieve ICAO codes using the Airports API endpoint.
`airline_name`	[Optional] Filter your results by airline IATA code. You can retrieve airline IATA codes using the Airlines API endpoint.
`airline_iata`	[Optional] Filter your results by airline IATA code. You can retrieve airline IATA codes using the Airlines API endpoint.
`flight_number`	[Optional] Filter your results by providing a flight number. Example: 2557
`flight_iata`	[Optional] Filter your results by providing a flight IATA code. Example: MU2557
`min_delay_dep`	[Optional] Filter your results by providing a minimum amount of minutes in departure delay. Example: 7 for seven minutes of delay in departure.
`min_delay_arr`	[Optional] Filter your results by providing a minimum amount of minutes in arrival delay. Example: 7 for seven minutes of delay in arrival.
`max_delay_dep`	[Optional] Filter your results by providing a maximum amount of minutes in departure delay. Example: 60 for one hour of delay in departure.
`max_delay_arr`	[Optional] Filter your results by providing a maximum amount of minutes in arrival delay. Example: 60 for one hour of delay in arrival.
`arr_scheduled_time_arr`	[Optional] Filter your results by providing a arrival date in the format YYYY-MM-DD. Example: 2019-02-31
`arr_scheduled_time_dep`	[Optional] Filter your results by providing a departure date in the format YYYY-MM-DD. Example: 2019-02-31

Example API Response:

                  {
                    "data": [
                          {
                              "flight_date": "2022-02-18",
                              "flight_status": "scheduled",
                              "departure": {
                                  "airport": "Kingsford Smith",
                                  "timezone": "Australia\/Sydney",
                                  "iata": "SYD",
                                  "icao": "YSSY",
                                  "terminal": "3",
                                  "gate": "T3G",
                                  "delay": 10,
                                  "scheduled": "2022-02-18T08:40:00+00:00",
                                  "estimated": "2022-02-18T08:40:00+00:00",
                                  "actual": null,
                                  "estimated_runway": null,
                                  "actual_runway": null
                              },
                              "arrival": {
                                  "airport": "Port Macquarie",
                                  "timezone": "Australia\/Sydney",
                                  "iata": "PQQ",
                                  "icao": "YPMQ",
                                  "terminal": "2",
                                  "gate": null,
                                  "baggage": null,
                                  "delay": null,
                                  "scheduled": "2022-02-18T09:40:00+00:00",
                                  "estimated": "2022-02-18T09:40:00+00:00",
                                  "actual": null,
                                  "estimated_runway": null,
                                  "actual_runway": null
                              },
                              "airline": {
                                  "name": "Emirates",
                                  "iata": "EK",
                                  "icao": "UAE"
                              },
                              "flight": {
                                  "number": "5159",
                                  "iata": "EK5159",
                                  "icao": "UAE5159",
                                  "codeshared": {
                                    "airline_name" : "qantas",
                                    "airline_iata" : "qf",
                                    "airline_icao" : "qfa",
                                    "flight_number" : "2160",
                                    "flight_iata" : "qf2160",
                                    "flight_icao" : "qfa2160"
                                  }
                              },
                              "aircraft": null,
                              "live": null,
                          }, 
                          [...]
                         ]
                        }

API Response Objects:

Response Object	Description
`flight_date`	Returns the date of the flight. Format: `YYYY-MM-DD`
`flight_status`	Returns the flight status. Possible values: `scheduled`, `active`, `landed`, `cancelled`, `incident`, `diverted`
`departure` > `airport`	Returns the name of the departure airport.
`departure` > `timezone`	Returns the departure timezone. Example: `America/Los_Angeles`
`departure` > `iata`	Returns the IATA code of the departure location/airport.
`departure` > `icao`	Returns the ICAO code of the departure location/airport.
`departure` > `terminal`	Returns the departure terminal.
`departure` > `gate`	Returns the departure gate.
`departure` > `delay`	Returns the delay in departure in minutes.
`departure` > `scheduled`	Returns the scheduled departure date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`departure` > `estimated`	Returns the estimated departure date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`departure` > `actual`	Returns the actual departure date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`departure` > `estimated_runway`	Returns the estimated runway date and time in RFC3339 (ISO8601) format in the departure location/airport. Example: `2019-12-12T04:20:00+00:00`
`departure` > `actual_runway`	Returns the actual runway date and time in the departure location/airport in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`arrival` > `airport`	Returns the name of the arrival airport.
`arrival` > `timezone`	Returns the arrival timezone. Example: `America/Los_Angeles`
`arrival` > `iata`	Returns the IATA code of the arrival location/airport.
`arrival` > `icao`	Returns the ICAO code of the arrival location/airport.
`arrival` > `terminal`	Returns the arrival terminal.
`arrival` > `gate`	Returns the arrival gate.
`arrival` > `baggage`	Returns the baggage claim gate at the arrival airport.
`arrival` > `delay`	Returns the delay in arrival in minutes.
`arrival` > `scheduled`	Returns the scheduled arrival date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`arrival` > `estimated`	Returns the actual arrival date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`arrival` > `actual`	Returns the actual arrival date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`arrival` > `estimated_runway`	Returns the estimated runway date and time in the arrival location/airport in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`arrival` > `actual_runway`	Returns the actual runway date and time in the arrival location/airport in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`airline` > `name`	Returns the name of the airline. Example: `American Airlines`
`airline` > `iata`	Returns the IATA code of the airline. Example: `AA`
`airline` > `icao`	Returns the ICAO code of the airline. Example: `AAL`
`flight` > `number`	Returns the flight number. Example: `1004`
`flight` > `iata`	Returns the IATA number of the flight. Example: `AA1004`
`flight` > `icao`	Returns the ICAO number of the flight. Example: `AAL1004`
`flight` > `codeshared`	Returns one or multiple sub-objects containing details about other flights and airlines participating in a codeshare agreement associated with the current flight.
`live` > `updated`	Returns the exact date and time the `live` data was collected in RFC3339 (ISO8601) format.
`live` > `latitude`	Returns the latitude coordinate associated with the aircraft location.
`live` > `longitude`	Returns the longitude coordinate associated with the aircraft location.
`live` > `altitude`	Returns the altitude (in meters) of the aircraft at the given time.
`live` > `direction`	Returns the direction (in degrees) of the aircraft at the given time.
`live` > `speed_horizontal`	Returns the horizontal speed (in kilometers per hour) of the aircraft at the given time.
`live` > `speed_vertical`	Returns the vertical speed (in kilometers per hour) of the aircraft at the given time.
`live` > `is_ground`	Returns `true` or `false` depending on whether or not the aircraft is on the ground at the given time.
`live` > `aircraft` > `registration`	Returns the registration number of the aircraft. Example: `N160AN`
`live` > `aircraft` > `iata`	Returns the IATA code of the aircraft. Example: `A321`
`live` > `aircraft` > `icao`	Returns the ICAO code of the aircraft. Example: `A321`
`live` > `aircraft` > `icao24`	Returns the ICAO24 code of the aircraft. Example: `A0F1BB`

Historical Flights

Apart from providing data about real-time flight, the API's flights endpoint is also capable of looking up data about historical flights.

Example API Request:

https://app.goflightlabs.com/historical/2022-03-14?access_key=YOUR_ACCESS_KEY

Example API Request with parameters:

https://app.goflightlabs.com/historical/2022-03-14?access_key=YOUR_ACCESS_KEY&flight_status=cancelled

HTTP GET Request Parameters:

Object	Description
`access_key`	[Required] Your API access key, which can be found in your acccount dashboard.
`flight_status`	[Optional] Filter your results by flight status. Available values: scheduled, active, landed, cancelled, incident, diverted
`dep_iata`	[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.
`arr_iata`	[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.
`dep_icao`	[Optional] Filter your results by departure airport using an ICAO code. You can retrieve ICAO codes using the Airports API endpoint.
`arr_icao`	[Optional] Filter your results by arrival airport using an ICAO code. You can retrieve ICAO codes using the Airports API endpoint.
`airline_name`	[Optional] Filter your results by airline IATA code. You can retrieve airline IATA codes using the Airlines API endpoint.
`airline_iata`	[Optional] Filter your results by flight status. Available values: scheduled, active, landed, cancelled, incident, diverted
`flight_number`	[Optional] Filter your results by providing a flight number. Example: 2557
`flight_iata`	[Optional] Filter your results by providing a flight IATA code. Example: MU2557
`min_delay_dep`	[Optional] Filter your results by providing a minimum amount of minutes in departure delay. Example: 7 for seven minutes of delay in departure.
`min_delay_arr`	[Optional] Filter your results by providing a minimum amount of minutes in arrival delay. Example: 7 for seven minutes of delay in arrival.
`max_delay_dep`	[Optional] Filter your results by providing a maximum amount of minutes in departure delay. Example: 60 for one hour of delay in departure.
`max_delay_arr`	[Optional] Filter your results by providing a maximum amount of minutes in arrival delay. Example: 60 for one hour of delay in arrival.
`arr_scheduled_time_arr`	[Optional] Filter your results by providing a arrival date in the format YYYY-MM-DD. Example: 2019-02-31
`arr_scheduled_time_dep`	[Optional] Filter your results by providing a departure date in the format YYYY-MM-DD. Example: 2019-02-31

Example API Response:

                    {
                      "data": [
                          {
                              "flight_date": "2022-02-17",
                              "flight_status": "landed",
                              "departure": {
                                  "airport": "Abakan",
                                  "timezone": "Asia/Krasnoyarsk",
                                  "iata": "ABA",
                                  "icao": "UNAA",
                                  "terminal": null,
                                  "gate": null,
                                  "delay": 1,
                                  "scheduled": "2022-02-17T07:45:00+00:00",
                                  "estimated": "2022-02-17T07:45:00+00:00",
                                  "actual": "2022-02-17T07:46:00+00:00",
                                  "estimated_runway": "2022-02-17T07:46:00+00:00",
                                  "actual_runway": "2022-02-17T07:46:00+00:00"
                              },
                              "arrival": {
                                  "airport": "Domodedovo",
                                  "timezone": "Europe/Moscow",
                                  "iata": "DME",
                                  "icao": "UUDD",
                                  "terminal": "1",
                                  "gate": null,
                                  "baggage": "3",
                                  "delay": null,
                                  "scheduled": "2022-02-17T08:55:00+00:00",
                                  "estimated": "2022-02-17T08:55:00+00:00",
                                  "actual": "2022-02-17T08:46:00+00:00",
                                  "estimated_runway": "2022-02-17T08:46:00+00:00",
                                  "actual_runway": "2022-02-17T08:46:00+00:00"
                              },
                              "airline": {
                                  "name": "S7 Airlines",
                                  "iata": "S7",
                                  "icao": "SBI"
                              },
                              "flight": {
                                  "number": "2594",
                                  "iata": "S72594",
                                  "icao": "SBI2594",
                                  "codeshared": null
                              },
                              "aircraft": {
                                "registration": "43BEA6",
                                "iata": "A20N",
                                "icao": "A20N",
                                "icao24": "VP-BTX"
                              },
                              "live": null,
                          }, 
                          [...]
                         ]
                    }

API Response Objects:

Response Object	Description
`flight_date`	Returns the date of the flight. Format: `YYYY-MM-DD`
`flight_status`	Returns the flight status. Possible values: `scheduled`, `active`, `landed`, `cancelled`, `incident`, `diverted`
`departure` > `airport`	Returns the name of the departure airport.
`departure` > `timezone`	Returns the departure timezone. Example: `America/Los_Angeles`
`departure` > `iata`	Returns the IATA code of the departure location/airport.
`departure` > `icao`	Returns the ICAO code of the departure location/airport.
`departure` > `terminal`	Returns the departure terminal.
`departure` > `gate`	Returns the departure gate.
`departure` > `delay`	Returns the delay in departure in minutes.
`departure` > `scheduled`	Returns the scheduled departure date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`departure` > `estimated`	Returns the estimated departure date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`departure` > `actual`	Returns the actual departure date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`departure` > `estimated_runway`	Returns the estimated runway date and time in RFC3339 (ISO8601) format in the departure location/airport. Example: `2019-12-12T04:20:00+00:00`
`departure` > `actual_runway`	Returns the actual runway date and time in the departure location/airport in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`arrival` > `airport`	Returns the name of the arrival airport.
`arrival` > `timezone`	Returns the arrival timezone. Example: `America/Los_Angeles`
`arrival` > `iata`	Returns the IATA code of the arrival location/airport.
`arrival` > `icao`	Returns the ICAO code of the arrival location/airport.
`arrival` > `terminal`	Returns the arrival terminal.
`arrival` > `gate`	Returns the arrival gate.
`arrival` > `baggage`	Returns the baggage claim gate at the arrival airport.
`arrival` > `delay`	Returns the delay in arrival in minutes.
`arrival` > `scheduled`	Returns the scheduled arrival date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`arrival` > `estimated`	Returns the actual arrival date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`arrival` > `actual`	Returns the actual arrival date and time in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`arrival` > `estimated_runway`	Returns the estimated runway date and time in the arrival location/airport in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`arrival` > `actual_runway`	Returns the actual runway date and time in the arrival location/airport in RFC3339 (ISO8601) format. Example: `2019-12-12T04:20:00+00:00`
`airline` > `name`	Returns the name of the airline. Example: `American Airlines`
`airline` > `iata`	Returns the IATA code of the airline. Example: `AA`
`airline` > `icao`	Returns the ICAO code of the airline. Example: `AAL`
`flight` > `number`	Returns the flight number. Example: `1004`
`flight` > `iata`	Returns the IATA number of the flight. Example: `AA1004`
`flight` > `icao`	Returns the ICAO number of the flight. Example: `AAL1004`
`flight` > `codeshared`	Returns one or multiple sub-objects containing details about other flights and airlines participating in a codeshare agreement associated with the current flight.
`live` > `updated`	Returns the exact date and time the `live` data was collected in RFC3339 (ISO8601) format.
`live` > `latitude`	Returns the latitude coordinate associated with the aircraft location.
`live` > `longitude`	Returns the longitude coordinate associated with the aircraft location.
`live` > `altitude`	Returns the altitude (in meters) of the aircraft at the given time.
`live` > `direction`	Returns the direction (in degrees) of the aircraft at the given time.
`live` > `speed_horizontal`	Returns the horizontal speed (in kilometers per hour) of the aircraft at the given time.
`live` > `speed_vertical`	Returns the vertical speed (in kilometers per hour) of the aircraft at the given time.
`live` > `is_ground`	Returns `true` or `false` depending on whether or not the aircraft is on the ground at the given time.
`live` > `aircraft` > `registration`	Returns the registration number of the aircraft. Example: `N160AN`
`live` > `aircraft` > `iata`	Returns the IATA code of the aircraft. Example: `A321`
`live` > `aircraft` > `icao`	Returns the ICAO code of the aircraft. Example: `A321`
`live` > `aircraft` > `icao24`	Returns the ICAO24 code of the aircraft. Example: `A0F1BB`

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 parameters:

https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&airline_icao=DLA

HTTP GET Request Parameters:

Object	Description
`access_key`	[Required] Your API access key, which can be found in your acccount dashboard.
`flight_number`	[Optional] Filter your results by providing a flight number. Example: 2557
`dep_iata`	[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.
`arr_iata`	[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.
`dep_icao`	[Optional] Filter your results by departure airport using an ICAO code. You can retrieve ICAO codes using the Airports API endpoint.
`arr_icao`	[Optional] Filter your results by arrival airport using an ICAO code. You can retrieve ICAO codes using the Airports API endpoint.
`airline_iata`	[Optional] Filter your results by airline IATA code. You can retrieve airline IATA codes using the Airlines API endpoint.
`airline_icao`	[Optional] Filter your results by airline ICAO code. You can retrieve airline ICAO codes using the Airlines API endpoint.

Example API Response:

                  {
                    "data": [
                        {
                          "departure": {
                              "airport": "Brussels Airport",
                              "timezone": "Europe/Brussels",
                              "iata": "BRU",
                              "icao": "EBBR",
                              "terminal": null,
                              "time": "06:10:00"
                          },
                          "arrival": {
                              "airport": "Girona-Costa Brava",
                              "timezone": "Europe/Madrid",
                              "iata": "GRO",
                              "icao": "LEGE",
                              "terminal": "1",
                              "time": "07:55:00"
                          },
                          "airline": {
                              "name": "Brussels Airlines",
                              "callsign": "B-LINE",
                              "iata": "SN",
                              "icao": "BEL"
                          },
                          "flight": {
                              "number": "3683"
                          }
                        },
                        [...]
                    ]
                  }

API Response Objects:

Response Object	Description
`departure` > `airport`	Returns the name of the departure airport.
`departure` > `timezone`	Returns the departure timezone. Example: `America/Los_Angeles`
`departure` > `iata`	Returns the IATA code of the departure location/airport.
`departure` > `icao`	Returns the ICAO code of the departure location/airport.
`departure` > `terminal`	Returns the departure terminal.
`departure` > `time`	Returns the departure time.
`arrival` > `airport`	Returns the name of the arrival airport.
`arrival` > `timezone`	Returns the arrival timezone. Example: `America/Los_Angeles`
`arrival` > `iata`	Returns the IATA code of the arrival location/airport.
`arrival` > `icao`	Returns the ICAO code of the arrival location/airport.
`arrival` > `terminal`	Returns the arrival terminal.
`arrival` > `time`	Returns the departure time.
`airline` > `name`	Returns the name of the airline. Example: `American Airlines`
`airline` > `callsign`	Returns the ICAO callsign of the airline.
`airline` > `iata`	Returns the IATA code of the airline. Example: `AA`
`airline` > `icao`	Returns the ICAO code of the airline. Example: `AAL`
`flight` > `number`	Returns the flight number. Example: `1004`

Airports

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

Example API Request:

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

API request example with search parameter

https://app.goflightlabs.com/airports?access_key=YOUR_ACCESS_KEY&search=Doha International

HTTP GET Request Parameters:

Object	Description
`access_key`	[Required] Your API access key, which can be found in your acccount dashboard.
`search`	[Optional] Use this parameter to get autocomplete suggestions for airports by specifying any search term as a string.

Example API Response:

                  {
                    "data": [
                        {
                            "id": "1",
                            "gmt": "-10",
                            "airport_id": "1",
                            "iata_code": "AAA",
                            "city_iata_code": "AAA",
                            "icao_code": "NTGA",
                            "country_iso2": "PF",
                            "geoname_id": "6947726",
                            "latitude": "-17.05",
                            "longitude": "-145.41667",
                            "airport_name": "Anna",
                            "country_name": "French Polynesia",
                            "phone_number": null,
                            "timezone": "Pacific/Tahiti"
                            ,
                            [...]
                          ]
                        }

API Response Objects:

Response Object	Description
`airport_name`	Returns the full name of the airport.
`iata_code`	Returns the IATA code associated with the airport.
`icao_code`	Returns the ICAO code associated with the airport.
`latitude`	Returns the latitude coordinate associated with the airport location.
`longitude`	Returns the longitude coordinate associated with the airport location.
`geoname_id`	Returns the GeoNames ID of the airport.
`timezone`	Returns the timezone the airport is in. Example: `America/Los_Angeles`
`gmt`	Returns the GMT offset in hours.
`phone_number`	Returns the phone number of the airport.
`country_name`	Returns the name of the country the airport is in.
`country_iso2`	Returns the ISO code of the country the airport is in.
`city_iata_code`	Returns the IATA code of the city the airport is in.

Airlines

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

Example API Request:

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

API request example with search parameter

https://app.goflightlabs.com/airlines?access_key=YOUR_ACCESS_KEY&search=Air Dolomiti

HTTP GET Request Parameters:

Object	Description
`access_key`	[Required] Your API access key, which can be found in your acccount dashboard.
`search`	[Optional] Use this parameter to get autocomplete suggestions for airlines by specifying any search term as a string.

Example API Response:

                  {
                         "data": [
                                    {
                                      "airline_name": "American Airlines",
                                      "iata_code": "AA",
                                      "iata_prefix_accounting": "1",
                                      "icao_code": "AAL",
                                      "callsign": "AMERICAN",
                                      "type": "scheduled",
                                      "status": "active",
                                      "fleet_size": "963",
                                      "fleet_average_age": "10.9",
                                      "date_founded": "1934",
                                      "hub_code": "DFW",
                                      "country_name": "United States",
                                      "country_iso2": "US"
                                    },
                                    [...]
                                ]
                        }

API Response Objects:

Response Object	Description
`airline_name`	Returns the full name of the airline.
`iata_code`	Returns the IATA code of the airline.
`iata_prefix_accounting`	Returns the IATA prefix or accounting code of the airline.
`icao_code`	Returns the ICAO code of the airline.
`callsign`	Returns the ICAO callsign of the airline.
`type`	Returns the type of airline.
`status`	Returns the current status of the airline.
`fleet_size`	Returns the fleet size of the airline.
`fleet_average_age`	Returns the average aircraft age of the fleet.
`date_founded`	Returns the founding year of the airline.
`hub_code`	Returns the hub code associated with the airline.
`country_name`	Returns the name of the origin country of the airline.
`country_iso2`	Returns the 2-letter ISO code of the origin country of the airline.

Airplanes

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

Example API Request:

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

API request example with search parameter

https://app.goflightlabs.com/airplanes?access_key=YOUR_ACCESS_KEY&search=Boeing

HTTP GET Request Parameters:

Object	Description
`access_key`	[Required] Your API access key, which can be found in your acccount dashboard.
`search`	[Optional] Use this parameter to get autocomplete suggestions for airplanes by specifying any search term as a string.

Example API Response:

                  {
                    "data": [
                            {
                              "registration_number": "YR-BAC",
                              "production_line": "Boeing 737 Classic",
                              "iata_type": "B737-300",
                              "model_name": "737",
                              "model_code": "B737-377",
                              "icao_code_hex": "4A0823",
                              "iata_code_short": "B733",
                              "construction_number": "23653",
                              "test_registration_number": null,
                              "rollout_date": null,
                              "first_flight_date": "1986-08-02T22:00:00.000Z",
                              "delivery_date": "1986-08-21T22:00:00.000Z",
                              "registration_date": "0000-00-00",
                              "line_number": "1260",
                              "plane_series": "377",
                              "airline_iata_code": "0B",
                              "airline_icao_code": null,
                              "plane_owner": "Airwork Flight Operations Ltd",
                              "engines_count": "2",
                              "engines_type": "JET",
                              "plane_age": "31",
                              "plane_status": "active",
                              "plane_class": null
                            },
                            [...]
                        ]
                  }

API Response Objects:

Response Object	Description
`registration_number`	Returns the registration number of the airplane.
`production_line`	Returns the production line identifier of the airplane.
`iata_type`	Returns the IATA type of the airplane.
`model_name`	Returns the model name of the airplane.
`model_code`	Returns the model code of the airplane.
`icao_code_hex`	Returns the HEX ICAO code of the airplane.
`iata_code_short`	Returns the short IATA code of the airplane.
`construction_number`	Returns the construction number of the airplane.
`test_registration_number`	Returns the test registration number of the airplane.
`rollout_date`	Returns the rollout date of the airplane.
`first_flight_date`	Returns the first flight date of the airplane.
`delivery_date`	Returns the initial delivery date of the airplane.
`registration_date`	Returns the initial registration date of the airplane.
`line_number`	Returns the production line number of the airplane.
`plane_series`	Returns the airplane series.
`airline_iata_code`	Returns the IATA code of the airplane.
`airline_icao_code`	Returns the ICAO code of the airplane.
`plane_owner`	Returns the owner name of the airplane.
`engines_count`	Returns the number of engines on the airplane.
`engines_type`	Returns the type of engines on the airplane.
`plane_age`	Returns the age of the airplane in years.
`plane_status`	Returns the current status of the airplane.
`plane_class`	Returns one or multiple sub-objects containing information about the types of classes (e.g. Economy Class, Business Class) are available ont the given airplane as well as details about the number of seats available, beds, cabin width, and more.

Aircraft Types

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

Example API Request:

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

API request example with search parameter

https://app.goflightlabs.com/aircraft_types?access_key=YOUR_ACCESS_KEY&search=British Aerospace Jetstream

HTTP GET Request Parameters:

Object	Description
`access_key`	[Required] Your API access key, which can be found in your acccount dashboard.
`search`	[Optional] Use this parameter to get autocomplete suggestions for aircraft types by specifying any search term as a string.

Example API Response:

                  {
                    "data": [
                        {
                          "aircraft_name": "Fokker 100",
                          "iata_code": "100"
                        },
                        [...]
                    ]
                  }

API Response Objects:

Response Object	Description
`aircraft_name`	Returns the aircraft name associated with the aircraft type.
`iata_code`	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 search parameter

https://app.goflightlabs.com/taxes?access_key=YOUR_ACCESS_KEY&search=Value Added Tax

HTTP GET Request Parameters:

Object	Description
`access_key`	[Required] Your API access key, which can be found in your acccount dashboard.
`search`	[Optional] Use this parameter to get autocomplete suggestions for aviation taxes by specifying any search term as a string.

Example API Response:

                  {
                      "data": [
                                {
                                  "tax_name": "Government Tax",
                                  "iata_code": "AB"
                                },
                                [...]
                            ]
                  }

API Response Objects:

Response Object	Description
`tax_name`	Returns the name of the aviation tax.
`iata_code`	Returns the IATA code associated with the aviation tax.

Cities

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

Example API Request:

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

API request example with search parameter

https://app.goflightlabs.com/cities?access_key=YOUR_ACCESS_KEY&search=buenos aires

HTTP GET Request Parameters:

Object	Description
`access_key`	[Required] Your API access key, which can be found in your acccount dashboard.
`search`	[Optional] Use this parameter to get autocomplete suggestions for cities by specifying any search term as a string.

Example API Response:

                  {
                      "data": [
                          {
                            "city_name": "Anaa",
                            "iata_code": "AAA",
                            "country_iso2": "PF",
                            "latitude": "-17.05",
                            "longitude": "-145.41667",
                            "timezone": "Pacific/Tahiti",
                            "gmt": "-10",
                            "geoname_id": "0"
                          },
                          [...]
                      ]
                  }

API Response Objects:

Response Object	Description
`city_name`	Returns the name of the city.
`iata_code`	Returns the IATA code of the city.
`country_iso2`	Returns the 2-letter ISO code of the city.
`latitude`	Returns the latitude coordinate associated with the city.
`longitude`	Returns the longitude coordinate associated with the city.
`timezone`	Returns the timezone the city is in.
`gmt`	Returns the GMT offset in hours.
`geoname_id`	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:

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

API request example with search parameter

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

HTTP GET Request Parameters:

Object	Description
`access_key`	[Required] Your API access key, which can be found in your acccount dashboard.
`search`	[Optional] Use this parameter to get autocomplete suggestions for countries by specifying any search term as a string.

Example API Response:

                  {
                      "data": [
                        {
                          "country_name": "Andorra",
                          "country_iso2": "AD",
                          "country_iso3": "AND",
                          "country_iso_numeric": "20",
                          "population": "84000",
                          "capital": "Andorra la Vella",
                          "continent": "EU",
                          "currency_name": "Euro",
                          "currency_code": "EUR",
                          "fips_code": "AN",
                          "phone_prefix": "376"
                        },
                        [...]
                    ]
                  }

API Response Objects:

Response Object	Description
`country_name`	Returns the name of the country.
`country_iso2`	Returns the 2-letter ISO code of the country.
`country_iso3`	Returns the 3-letter ISO code of the country.
`country_iso_numeric`	Returns the numeric ISO code of the country.
`population`	Returns the population of the country.
`capital`	Returns the capital of the country.
`continent`	Returns the continent the country is located in.
`currency_name`	Returns the name of the currency associated with the country.
`currency_code`	Returns the code of the currency associated with the country.
`fips_code`	Returns the FIPS code of the country.
`phone_prefix`	Returns the phone prefix associated with the country.

Examples

PHP cURL

                $queryString = http_build_query([
                "access_key" => "YOUR_ACCESS_KEY"
                ]);

                $ch = curl_init(sprintf("%s?%s", "http://app.goflightlabs.com/flights", $queryString));

                curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
            
                $json = curl_exec($ch);
                curl_close($ch);
            
                $api_result = json_decode($json, true);
                
                return $api_result;

Python

                import requests

                params = {
                  'access_key': 'YOUR_ACCESS_KEY'
                }

                api_result = requests.get('https://app.goflightlabs.com/flights', params)

                api_response = api_result.json()