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

Flight Data


This endpoint is capable of bringing real-time information about a specific flight in the world and retrieving flight status information in real time.

Example API Request With Flight Number Parameter:

https://app.goflightlabs.com/flight?access_key=YOUR_ACCESS_KEY&flight_number=3o375

Real-Time Flights


This endpoint is capable of information about all flights in the world flights and retrieving flight status information in real-time. In order to look up real-time information about one or multiple flights.
Data is being updated every 10 minutes

Example API Request:

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

Example API Request with limit parameter:

https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&limit=100

Example API Request with Flight Iata parameter:

https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&flightIata=BA179

Example API Request with airline Iata parameter:

https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&airlineIata=W8

Example API Request with departure location Iata parameter:

https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&depIata=MAD

Example API Request with arrival location Iata parameter:

https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&arrIata=GIG


HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
limit [Optional] Limit value for output, integer max 10000
flightIata [Optional] Flight IATA code
flightIcao [Optional] Flight ICAO code
flightNum [Optional] Flight Number
airlineIata [Optional] Airline IATA code
airlineIcao [Optional] Airline ICAO code
depIata [Optional] Departure airport IATA code
depIcao [Optional] Departure airport ICAO code
arrIata [Optional] Arrival airport IATA code
arrIcao [Optional] Arrival airport ICAO code
aircraftIcao [Optional] Aircraft ICAO code
regNum [Optional] Aircraft registration number
aircraftIcao24 [Optional] Aircraft ICAO24 code
status [Optional] Status of the flight (started, en-route, landed, unknown)

Example API Response:

                
                  {
                    "success": true,
                    "data": [
                          {
                            "aircraft": {
                                "iataCode":"B789",
                                "icao24":"C01040",
                                "icaoCode":"B789",
                                "regNumber":"C-FGDZ"
                            },
                            "airline": {
                                "iataCode":"AC",
                                "icaoCode":"ACA"
                            },
                            "arrival" : {
                                "iataCode":"GRU",
                                "icaoCode":"SBGR"
                            },
                            "departure" : {
                                "iataCode":"EZE",
                                "icaoCode":"SAEZ"
                            },
                            "flight" : {
                                "iataNumber":"AC91",
                                "icaoNumber":"ACA091",
                                "number":"91"
                            },
                            "geography" : {
                                "altitude":12496.8,
                                "direction":31.15,
                                "latitude":-26.98,
                                "longitude":-49.95
                            },
                            "speed" : {
                                "horizontal":880.74,
                                "isGround":0,
                                "vspeed":-1.188
                            },
                            "status":"en-route",
                            "system" : {
                                "squawk":null,
                                "updated":1665523076
                            }
                          },
                          { ... },
                          ]
                        }
                
              

API Response Objects:

Response Object Description
aircraft Returns the aircraft data. Format: Array
aircraft > iataCode Returns the IATA code.
aircraft > icao24 Returns the Aircraft ICAO24 code. Example: C01040
aircraft > icaoCode Returns the ICAO code.
aircraft > regNumber Returns the Aircraft registration number.
airline Returns the array data.
airline > iataCode Returns the IATA code Airline.
airline > icaoCode Returns the ICAO code Airline.
arrival Returns array data
arrival > iataCode Returns the arrival airport IATA code .
arrival > icaoCode Returns the arrival airport ICAO code.
departure Returns array data
departure > iataCode Returns the departure airport IATA code.
departure > icaoCode Returns the departure airport ICAO code.
flight Returns the data array.
flight > iataNumber Returns the IATA Number.
flight > icaoNumber Returns the ICAO Number.
flight > number Returns the number of flight.
geography Returns the data array.
geography > altitude Returns the altitude flight.
geography > direction Returns the direction flight.
geography > latitude Returns the latitude flight.
geography > longitude Returns the longitude flight.
speed > horinzontal Returns the horizontal speed
speed > isGround Returns the if is ground
speed > vspeed Returns the vertical speed
status Returns the status flight



Flight Schedules.


The API is capable of tracking flights and retrieving flight status information in real-time. In order to look up real-time information about one or multiple flights, you can use the API's flights endpoint together with optional parameters to filter your result set.

Example API Request:

https://app.goflightlabs.com/advanced-flights-schedules?access_key=YOUR_ACCESS_KEY

Example API Request For the departure schedule of a certain airport:

https://app.goflightlabs.com/advanced-flights-schedules?access_key=YOUR_ACCESS_KEY&iataCode=JFK&type=departure


HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
iataCode [Optional] The IATA code of the airport you'd like to request data from.
type [Optional] Flight type: departure or arrival
status [Optional] The status of the flight: landed, scheduled, cancelled, active, incident, diverted, redirected, unknown.
dep_iataCode [Optional] The IATA code of the departure airport (JFK, AMS, CDG, etc).
dep_icaoCode [Optional] The ICAO code of the departure airport (KJFK, EHAM, LFPG, etc).
dep_terminal [Optional] The terminal at the departure airport (1, 2, 3, 4, etc).
dep_delay [Optional] The delay in minutes at departure (10, 20, 45, etc) it is not possible to set a delay range.
dep_schTime [Optional] The scheduled flight's departure in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000
dep_actTime [Optional] The actual flight departure time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000
dep_estRunway [Optional] The estimated departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000
dep_actRunway [Optional] The actual departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000
arr_iataCode [Optional] The IATA code of the arrival airport (JFK, AMS, CDG, etc).
arr_icaoCode [Optional] The ICAO code of the arrival airport (KJFK, EHAM, LFPG, etc).
arr_terminal [Optional] The terminal at the arrival airport (1, 2, 3, 4, etc)
arr_delay [Optional] The delay in minutes at arrival (10, 20, 45, etc) it is not possible to set a delay range
arr_schTime [Optional] The scheduled flight's arrival in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000
arr_estTime [Optional] The actual flight arrival time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000
arr_estRunway [Optional] The estimated arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000
arr_estRunway [Optional] The actual arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000
airline_name [Optional] Name of the airline (Air France, American Airlines, Delta Air Lines, etc) (may need air%20france, american%20airlines, delta%20air%20lines is the response has problems)
airline_iata [Optional] IATA code of airline
airline_icao [Optional] ICAO code of airline
flight_num [Optional] The flight number based on 1 to 4 digits, for example: 171
flight_iata [Optional] The flight iata number consisting of digits and letters, usually of the airline iata code. For example: AA171
flight_icao [Optional] The flight icao number consisting of digits and letters, usually the airline icao code. For example: AAL171
codeshared [Optional] If the flight is codeshared, this data will be included. If you don't want codeshared flights, you can input null

Example API Response:

                    
                      {
                        "success": true,
                        "data": 
                        [
                          {
                              "airline": {
                                  "iataCode": "TV",
                                  "icaoCode": "TBA",
                                  "name": "Tibet Airlines"
                              },
                              "arrival": {
                                  "actualRunway": null,
                                  "actualTime": null,
                                  "baggage": null,
                                  "delay": null,
                                  "estimatedRunway": null,
                                  "estimatedTime": "2022-11-07T16:17:00.000",
                                  "gate": null,
                                  "iataCode": "HJJ",
                                  "icaoCode": "ZGCJ",
                                  "scheduledTime": "2022-11-07T16:35:00.000",
                                  "terminal": "3"
                              },
                              "codeshared": {
                                  "airline": {
                                      "iataCode": "gj",
                                      "icaoCode": "cdc",
                                      "name": "loong air"
                                  },
                                  "flight": {
                                      "iataNumber": "gj8802",
                                      "icaoNumber": "cdc8802",
                                      "number": "8802"
                                  }
                              },
                              "departure": {
                                  "actualRunway": "2022-11-07T14:51:00.000",
                                  "actualTime": "2022-11-07T14:51:00.000",
                                  "baggage": null,
                                  "delay": "1",
                                  "estimatedRunway": "2022-11-07T14:51:00.000",
                                  "estimatedTime": "2022-11-07T14:52:00.000",
                                  "gate": "6",
                                  "iataCode": "LJG",
                                  "icaoCode": "ZPLJ",
                                  "scheduledTime": "2022-11-07T14:50:00.000",
                                  "terminal": null
                              },
                              "flight": {
                                  "iataNumber": "TV7104",
                                  "icaoNumber": "TBA7104",
                                  "number": "7104"
                              },
                              "status": "active",
                              "type": "arrival"
                          },
                          [{...}]
                        ]
                      }
                    
                  

API Response Objects:

Response Object Description
airline > iataCode Returns The IATA code of the airline.
airline > icaoCode Returns The ICAO code of the airline.
airline > name Returns The NAME of the airline.
arrival > actualRunway Returns The actual arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000.
arrival > actualTime Returns The actual time in the following format: YYYY-MM-DDT00:00:00.000.
arrival > baggage Returns The baggage.
arrival > delay Returns The delay.
arrival > estimatedRunway Returns The estimated arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000.
arrival > estimatedTime Returns The estimated arrival time in the following format: YYYY-MM-DDT00:00:00.000.
arrival > gate Returns The gate.
arrival > iataCode Returns The IATA CODE.
arrival > icaoCode Returns The ICAO CODE.
arrival > scheduledTime Returns The Scheduled Time.
arrival > terminal Returns The terminal.
codeshared > airline > airline Returns The IATA Code airline.
codeshared > airline > icaoCode Returns The ICAO Code airline.
codeshared > airline > name Returns The Name.
codeshared > flight > iataNumber Returns The IATA Code of flight.
codeshared > flight > icaoNumber Returns The ICAO Code of flight.
codeshared > flight > number Returns The number of flight.
departure > actualRunway Returns The actual departure time at runway in the following format: YYYY-MM-DDT00:00:00.000.
departure > actualTime Returns The actual time in the following format: YYYY-MM-DDT00:00:00.000.
departure > baggage Returns The baggage.
departure > delay Returns The delay.
departure > estimatedRunway Returns The estimated departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 .
departure > estimatedTime Returns The estimated departure time in the following format: YYYY-MM-DDT00:00:00.000.
departure > gate Returns The gate.
departure > iataCode Returns The IATA code of departure.
departure > icaoCode Returns The ICAO code of departure.
departure > scheduledTime Returns The Scheduled Time of departure.
departure > terminal Returns The terminal.
flight > iataNumber Returns The IATA number of flight.
flight > icaoNumber Returns The ICAO number of flight.
flight > number Returns The flight number.
status Returns The flight status.
type Returns The flight type.



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 For the departure schedule of a certain airport on a certain date:

https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure

Example API Request For the arrival schedule of a certain airport on a certain date:

https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=arrival

Example API Request For the schedule of a certain airport of a certain date range (also available for arrival):

https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-05-05

Example API Request For the schedule of a certain airport on a certain date (or range) but only flights with a certain status:

https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-05-05&status=cancelled

Example API Request For tracking individual historical flights:

https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-05-05&flight_number=5703

Example API Request For filtering the flights of a certain airline from the arrival schedule of a certain airport on a certain date (also available for departure schedules and as a date range):

https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-05-05&airline_iata=AY


HTTP GET Request Parameters:

Status can be: "active" (for departure schedules only), "landed" (for arrival schedules only), "cancelled", "unknown".

Delay amount is included in minutes if a flight was delayed at the date.

The maximum date range can be 30 days which may be reduced to 3-5 days for large airports with heavy traffic.

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
code [Required] Departure or arrival airport IATA code.
type [Required] Either "departure" or "arrival" as both within the same query is not possible.
date_to [Optional] Filter your results by end date of the requested date range.
dep_iataCode [Optional] Filter by departure airport if "arrival" for "&type=" was chosen, based on the airport IATA code.
arr_iataCode [Optional] Filter your results by arrival airport if "departure" for "&type=" was chosen, based on the airport IATA code.
airline_iata [Optional] Option to filter airline based on airline IATA code
flight_num [Optional] Option to filter a specific flight based on its flight number. Example: 5703

Example API Response:

                    
                      {
                        "data": [
                          {
                            "type":"arrival",
                            "status":"cancelled",
                            "departure": {
                              "iata_code":"MLA",
                              "icao_code":"LMML",
                              "scheduled_time":"2020-07-18T08:35:00.000"
                            },
                            "arrival": {
                                "iata_code":"LGW",
                                "icao_code":"EGKK",
                                "terminal":"S",
                                "scheduled_time":"2020-07-18T10:55:00.000"
                            },
                            "airline": {
                                "name":"Air Baltic",
                                "iata_code":"BT",
                                "icao_code":"BTI"
                            },
                            "flight": {
                                "number":"6079",
                                "iata_number":"BT6079",
                                "icao_number":"BTI6079"
                            },
                            "codeshared": {
                              "airline": {
                                "name":"Air Malta",
                                "iata_code":"KM",
                                "icao_code":"AMC"
                              },
                              "flight": {
                                "number":"116",
                                "iata_number":"KM116",
                                "icao_number":"AMC116"
                              }
                            }
                          }, 
                          [...]
                        ]
                      }
                    
                  

API Response Objects:

Response Object Description
type Returns the type flight
status Returns the flight status. Possible values: active (for departure schedules only), landed (for arrival schedules only), cancelled, unknown.
departure > iata_code Returns the IATA code of the departure airport.
departure > icao_code Returns the ICAO code of the departure airport.
departure > scheduled_time Returns the scheduled time.
arrival > iata_code Returns the IATA code of the arrival airport.
arrival > icao_code Returns the ICAO code of the arrival airport.
arrival > terminal Returns the terminal of the arrival airport.
arrival > scheduled_time Returns the scheduled time.
airline > name Returns the airline name.
airline > iata_code Returns the airline IATA code.
airline > icao_code Returns the airline ICAO code.
flight > number Returns the flight number.
flight > iata_number Returns the flight IATA number.
flight > icao_number Returns the flight ICAO number.
codeshared > airline > name Returns the airline name.
codeshared > airline > iata_code Returns the airline IATA code.
codeshared > airline > icao_code Returns the airline ICAO code.
codeshared > flight > number Returns the flight number.
codeshared > flight > iata_number Returns the flight IATA number.
codeshared > flight > icao_number Returns the flight ICAO number.





Future Flights


For the future flights endpoint you must enter a date more than 7 days from the current date.

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

https://app.goflightlabs.com/advanced-future-flights?access_key=YOUR_ACCESS_KEY&type=departure&iataCode=BER&date=2023-06-09

API request example For the arrival schedule of a certain airport on a certain future date.

https://app.goflightlabs.com/advanced-future-flights?access_key=YOUR_ACCESS_KEY&type=arrival&iataCode=BER&date=2023-06-09

API request example For the flights that are scheduled to arrive at a certain airport on a certain date (out of a departure schedule).

https://app.goflightlabs.com/advanced-future-flights?access_key=YOUR_ACCESS_KEY&type=departure&iataCode=JFK&arr_iataCode=LAX&date=2023-06-09

API request example For the flights that are scheduled to depart from a certain airport on a certain date (out of an arrival schedule).

https://app.goflightlabs.com/advanced-future-flights?access_key=YOUR_ACCESS_KEY&type=arrival&iataCode=BER&dep_iataCode=ory&date=2023-06-09


HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
iataCode [Required] Airport IATA code.
type [Required] Either "departure" or "arrival" as both within the same query is not possible.
date [Required] Future date in YYYY-MM-DD format and greater than 7 days from the current date.
dep_iataCode [Optional] Filter of departure airport if "arrival" for "&type=" was chosen, based on the airport IATA code.
dep_icaoCode [Optional] Filter of departure airport if "arrival" for "&type=" was chosen, based on the airport ICAO code.
arr_iataCode [Optional] Filter of arrival airport if "departure" for "&type=" was chosen, based on the airport IATA code.
arr_icaoCode [Optional] Filter of arrival airport if "departure" for "&type=" was chosen, based on the airport ICAO code.
arr_icaoCode [Optional] Filter airline based on airline IATA code.
airline_icao [Optional] Filter airline based on airline ICAO code.
flight_num [Optional] Filter a specific flight based on its flight number.

Example API Response:

                    
                      {
                        "data": [
                          {
                            "weekday": "4",
                            "departure": {
                              "iataCode": "lax",
                              "icaoCode": "klax",
                              "terminal": "4",
                              "gate": "A",
                              "scheduledTime": "12:00"
                            },
                            "arrival": {
                              "iataCode": "jfk",
                              "icaoCode": "kjfk",
                              "terminal": "8",
                              "gate": "B",
                              "scheduledTime": "20:35"
                            },
                            "aircraft": {
                              "modelCode": "a321",
                              "modelText": "airbus a321-231"
                            },
                            "airline": {
                              "name": "american airlines",
                              "iataCode": "aa",
                              "icaoCode": "aal"
                            },
                            "flight": {
                              "number": "274",
                              "iataNumber": "aa274",
                              "icaoNumber": "aal274"
                            }
                          },
                          [...]
                        ]
                      }
                    
                  

API Response Objects:

Response Object Description
weekday Returns the weekday number | 1 = monday, 7 = sunday.
departure > iataCode Returns the IATA code associated with the departure airport.
departure > icaoCode Returns the ICAO code associated with the departure airport.
departure > terminal Returns the terminal.
departure > gate Returns the gate.
departure > scheduledTime Returns the Scheduled Time.
arrival > iataCode Returns the IATA code associated with the arrival airport.
arrival > icaoCode Returns the ICAO code associated with the arrival airport.
arrival > terminal Returns the terminal associated with the arrival airport.
arrival > gate Returns the gate associated with the arrival airport.
arrival > scheduledTime Returns the Scheduled Time associated with the arrival airport.
aircraft > modelCode Returns the model code of aircraft.
aircraft > modelText Returns the model in text of aircraft.
airline > name Returns the name of airline.
airline > iataCode Returns the IATA code of airline.
airline > icaoCode Returns the ICAO code of airline.
flight > number Returns the flight number.
flight > iataNumber Returns the flight IATA number.
flight > icaoNumber Returns the flight ICAO number.



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://app.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://app.goflightlabs.com/airports?access_key=YOUR_ACCESS_KEY&codeIataAirport=AAH

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

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



Get airport data


Get airport data (IATA code, name, city, country).

Example API Request:

https://app.goflightlabs.com/get-airport-data?access_key=YOUR_ACCESS_KEY&query=berlin

API request example with search parameter

https://app.goflightlabs.com/get-airport-data?access_key=YOUR_ACCESS_KEY&query=berlin


HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
query [Required] Use this parameter to get autocomplete suggestions for matching airport data by specifying any country as a string.

Example API Response:

          
            {
              "success": true,
              "data": [
                  {
                      "iata_code": "BER",
                      "name": "Berlin Brandenburg",
                      "city": "Berlin",
                      "country": "Germany"
                  },
                  {
                      "iata_code": "BGO",
                      "name": "Bergen",
                      "city": "Bergen",
                      "country": "Norway"
                  },
                  {
                      "iata_code": "BRN",
                      "name": "Bern",
                      "city": "Bern",
                      "country": "Switzerland"
                  },
                  {
                      "iata_code": "BZE",
                      "name": "Belize City Philip S.W.Goldson Int",
                      "city": "Belize City",
                      "country": "Belize"
                  },
                  {
                      "iata_code": "BNI",
                      "name": "Benin City",
                      "city": "Benin City",
                      "country": "Nigeria"
                  }
              ]
            }
          
        

API Response Objects:

Response Object Description
iata_code Returns IATA Code of each airport.
name Returns the name of airport.
city Returns the name of city airport.
country Returns the name of country airport.



Search best flights


Start and poll best flights search with prices.

Example API Request:

https://app.goflightlabs.com/search-best-flights?access_key=YOUR_ACCESS_KEY&adults=1&origin=MAD&destination=FCO&departureDate=2023-06-11

API request example with search parameter

https://app.goflightlabs.com/search-best-flights?access_key=YOUR_ACCESS_KEY&adults=1&origin=MAD&destination=FCO&departureDate=2023-06-11


HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
adults [Required] Number of adult passengers (16 and over) Allowed values: 1-8.
origin [Required] Departure airport IATA code.
destination [Required] Destination airport IATA code.
departureDate [Required] Departure date Format: YYYY-MM-DD.
returnDate [Optional] Return date Format: YYYY-MM-DD.
cabinClass [Optional] Enum only accept 'economy', 'premiumeconomy', 'business', 'first'.
currency [Optional] Currency code (ISO 4217) Ex: EUR - USD as string.
childAge1 [Optional] Age of first child Allowed values: 0- 15.
childAge2 [Optional] Age of first child Allowed values: 0- 15.
childAge3 [Optional] Age of first child Allowed values: 0- 15.
childAge4 [Optional] Age of first child Allowed values: 0- 15.
childAge5 [Optional] Age of first child Allowed values: 0- 15.
childAge6 [Optional] Age of first child Allowed values: 0- 15.
childAge7 [Optional] Age of first child Allowed values: 0- 15.
childAge8 [Optional] Age of first child Allowed values: 0- 15.

Example API Response:

          

            {
              "success": true,
              "data": {
                  "buckets": [
                      {
                          "id": "Best",
                          "name": "Best",
                          "items": [
                              {
                                  "id": "13870-2210110630--31915-0-11493-2210110900",
                                  "price": {
                                      "raw": 75,
                                      "formatted": "75 €"
                                  },
                                  "legs": [
                                      {
                                          "id": "13870-2210110630--31915-0-11493-2210110900",
                                          "origin": {
                                              "id": "MAD",
                                              "name": "Madrid",
                                              "displayCode": "MAD",
                                              "city": "Madrid",
                                              "isHighlighted": false
                                          },
                                          "destination": {
                                              "id": "FCO",
                                              "name": "Rome Fiumicino",
                                              "displayCode": "FCO",
                                              "city": "Rome",
                                              "isHighlighted": false
                                          },
                                          "durationInMinutes": 150,
                                          "stopCount": 0,
                                          "isSmallestStops": true,
                                          "departure": "2022-10-11T06:30:00",
                                          "arrival": "2022-10-11T09:00:00",
                                          "timeDeltaInDays": 0,
                                          "carriers": {
                                              "marketing": [
                                                  {
                                                      "id": -31915,
                                                      "logoUrl": "https://logos.skyscnr.com/images/airlines/favicon/FR.png",
                                                      "name": "Ryanair"
                                                  }
                                              ],
                                              "operationType": "fully_operated"
                                          },
                                          "segments": [
                                              {
                                                  "id": "13870-11493-2210110630-2210110900--31915",
                                                  "origin": {
                                                      "flightPlaceId": "MAD",
                                                      "parent": {
                                                          "flightPlaceId": "MADR",
                                                          "name": "Madrid",
                                                          "type": "City"
                                                      },
                                                      "name": "Madrid",
                                                      "type": "Airport"
                                                  },
                                                  "destination": {
                                                      "flightPlaceId": "FCO",
                                                      "parent": {
                                                          "flightPlaceId": "ROME",
                                                          "name": "Rome",
                                                          "type": "City"
                                                      },
                                                      "name": "Rome Fiumicino",
                                                      "type": "Airport"
                                                  },
                                                  "departure": "2022-10-11T06:30:00",
                                                  "arrival": "2022-10-11T09:00:00",
                                                  "durationInMinutes": 150,
                                                  "flightNumber": "9674",
                                                  "marketingCarrier": {
                                                      "id": -31915,
                                                      "name": "Ryanair",
                                                      "alternateId": "FR",
                                                      "allianceId": 0
                                                  },
                                                  "operatingCarrier": {
                                                      "id": -31915,
                                                      "name": "Ryanair",
                                                      "alternateId": "FR",
                                                      "allianceId": 0
                                                  }
                                              }
                                          ]
                                      }
                                  ],
                                  "isSelfTransfer": false,
                                  "eco": {
                                      "ecoContenderDelta": 7.2873774
                                  },
                                  "isMashUp": false,
                                  "hasFlexibleOptions": false,
                                  "score": 3.14962
                              }
                          ]
                      }            
                  ]
              }
          }
          
        

API Response Objects:

Response Object Description
buckets Returns array with Best - Fastest - Cheapest - Direct flights.
id Returns id of kind of flights.
name Returns the name of kind of flights.
items Returns array of flights of each type.
id Returns id of flight.
price Returns price of flight.
legs Returns content information of flight.



Search flights


Return all available flights at moment.

Note: In this endpoint, the maximum number of flights returned in the response is 10.

Example API Request:

https://app.goflightlabs.com/search-all-flights?access_key=YOUR_ACCESS_KEY&adults=1&origin=MAD&destination=FCO&departureDate=2023-06-06

API request example with search parameter

https://app.goflightlabs.com/search-all-flights?access_key=YOUR_ACCESS_KEY&adults=1&origin=MAD&destination=FCO&departureDate=2023-06-06


HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
adults [Required] Number of adult (16 and over) passengers (1-8).
origin [Required] IATA code of origin airport.
destination [Required] IATA code of destination airport.
departureDate [Required] Date of first flight, format YYYY-MM-DD.
returnDate [Optional] Date of return flight, format YYYY-MM-DD - if omitted, one-way ticket itineraries are shown.
cabinClass [Optional] Class of ticket, possible values: economy, premiumeconomy, business, first - default: economy.
currency [Optional] Currency of flight prices, default: EUR.
childAge1 [Optional] Age of first child Allowed values: 0- 15.
childAge2 [Optional] Age of first child Allowed values: 0- 15.
childAge3 [Optional] Age of first child Allowed values: 0- 15.
childAge4 [Optional] Age of first child Allowed values: 0- 15.
childAge5 [Optional] Age of first child Allowed values: 0- 15.
childAge6 [Optional] Age of first child Allowed values: 0- 15.
childAge7 [Optional] Age of first child Allowed values: 0- 15.
childAge8 [Optional] Age of first child Allowed values: 0- 15.
stops [Optional] Comma separated filter for number of stops per leg, possible values 0, 1, and 2 (2 = 2+).
duration [Optional] Filter for maximum leg duration in hours.
startFrom [Optional] Outbound journey departs after, format HH:mm.
arriveTo [Optional] Outbound journey arrives before, format HH:mm.
returnStartFrom [Optional] Return journey departs after, format HH:mm.
returnArriveTo [Optional] Return journey arrives before, format HH:mm.

Example API Response:

          

            {
                "success": true,
                "data": {
                    "results": [
                        {
                            "id": "13870-2210111040--32480-1-11493-2210111725",
                            "legs": [
                                {
                                    "id": "13870-2210111040--32480-1-11493-2210111725",
                                    "origin": {
                                        "id": 13870,
                                        "name": "Madrid",
                                        "displayCode": "MAD"
                                    },
                                    "destination": {
                                        "id": 11493,
                                        "name": "Rome Fiumicino",
                                        "displayCode": "FCO"
                                    },
                                    "durationInMinutes": 405,
                                    "stopCount": 1,
                                    "isSmallestStops": true,
                                    "departure": "2022-10-11T10:40:00",
                                    "arrival": "2022-10-11T17:25:00",
                                    "timeDeltaInDays": 0,
                                    "carriers": {
                                        "marketing": [
                                            {
                                                "id": -32480,
                                                "name": "British Airways"
                                            }
                                        ],
                                        "operationType": "fully_operated"
                                    },
                                    "segments": [
                                        {
                                            "id": "13870-13554-2210111040-2210111200--32480",
                                            "origin": {
                                                "flightPlaceId": "MAD",
                                                "parent": {
                                                    "flightPlaceId": "MAD",
                                                    "name": "Madrid",
                                                    "type": "City"
                                                },
                                                "name": "Madrid",
                                                "type": "Airport"
                                            },
                                            "destination": {
                                                "flightPlaceId": "LHR",
                                                "parent": {
                                                    "flightPlaceId": "LON",
                                                    "name": "London",
                                                    "type": "City"
                                                },
                                                "name": "London Heathrow",
                                                "type": "Airport"
                                            },
                                            "departure": "2022-10-11T10:40:00",
                                            "arrival": "2022-10-11T12:00:00",
                                            "durationInMinutes": 140,
                                            "flightNumber": "457",
                                            "marketingCarrier": {
                                                "id": -32480,
                                                "name": "British Airways",
                                                "alternate_di": "BA",
                                                "allianceId": -32000
                                            },
                                            "operatingCarrier": {
                                                "id": -32480,
                                                "name": "British Airways",
                                                "alternate_di": "BA",
                                                "allianceId": -32000
                                            }
                                        },
                                        {
                                            "id": "13554-11493-2210111345-2210111725--32480",
                                            "origin": {
                                                "flightPlaceId": "LHR",
                                                "parent": {
                                                    "flightPlaceId": "LON",
                                                    "name": "London",
                                                    "type": "City"
                                                },
                                                "name": "London Heathrow",
                                                "type": "Airport"
                                            },
                                            "destination": {
                                                "flightPlaceId": "FCO",
                                                "parent": {
                                                    "flightPlaceId": "ROM",
                                                    "name": "Rome",
                                                    "type": "City"
                                                },
                                                "name": "Rome Fiumicino",
                                                "type": "Airport"
                                            },
                                            "departure": "2022-10-11T13:45:00",
                                            "arrival": "2022-10-11T17:25:00",
                                            "durationInMinutes": 160,
                                            "flightNumber": "556",
                                            "marketingCarrier": {
                                                "id": -32480,
                                                "name": "British Airways",
                                                "alternate_di": "BA",
                                                "allianceId": -32000
                                            },
                                            "operatingCarrier": {
                                                "id": -32480,
                                                "name": "British Airways",
                                                "alternate_di": "BA",
                                                "allianceId": -32000
                                            }
                                        }
                                    ]
                                }
                            ],
                            "pricing_options": [
                                {
                                    "agents": [
                                        {
                                            "id": "eduk",
                                            "name": "eDreams",
                                            "is_carrier": false,
                                            "update_status": "current",
                                            "optimised_for_mobile": true,
                                            "live_update_allowed": true,
                                            "rating_status": "available",
                                            "rating": 2.35,
                                            "feedback_count": 9130,
                                            "rating_breakdown": {
                                                "reliable_prices": 2.675344,
                                                "clear_extra_fees": 3.789988,
                                                "customer_service": 3.508816,
                                                "ease_of_booking": 3.248132,
                                                "other": 1.186932
                                            }
                                        }
                                    ],
                                    "price": {
                                        "amount": 255.81,
                                        "update_status": "current",
                                        "last_updated": "2022-09-14T17:38:00",
                                        "quote_age": 134
                                    }
                                },
                                {
                                    "agents": [
                                        {
                                            "id": "trup",
                                            "name": "travelup",
                                            "is_carrier": false,
                                            "update_status": "current",
                                            "optimised_for_mobile": true,
                                            "live_update_allowed": true,
                                            "rating_status": "available",
                                            "rating": 3.49,
                                            "feedback_count": 21357,
                                            "rating_breakdown": {
                                                "reliable_prices": 2.8393,
                                                "clear_extra_fees": 4.476256,
                                                "customer_service": 4.966728,
                                                "ease_of_booking": 4.006016,
                                                "other": 2.6659
                                            }
                                        }
                                    ],
                                    "price": {
                                        "amount": 256.86,
                                        "update_status": "current",
                                        "last_updated": "2022-09-14T19:44:00",
                                        "quote_age": 8
                                    }
                                },
                                {
                                    "agents": [
                                        {
                                            "id": "ba__",
                                            "name": "British Airways",
                                            "is_carrier": true,
                                            "update_status": "current",
                                            "optimised_for_mobile": true,
                                            "live_update_allowed": true,
                                            "rating_status": "available",
                                            "rating": 4.33,
                                            "feedback_count": 8103,
                                            "rating_breakdown": {
                                                "reliable_prices": 4.63556,
                                                "clear_extra_fees": 4.676892,
                                                "customer_service": 4.98788,
                                                "ease_of_booking": 4.538596,
                                                "other": 3.462924
                                            }
                                        }
                                    ],
                                    "price": {
                                        "amount": 262.31,
                                        "update_status": "current",
                                        "last_updated": "2022-09-14T13:37:00",
                                        "quote_age": 375
                                    }
                                },
                                {
                                    "agents": [
                                        {
                                            "id": "opuk",
                                            "name": "Opodo",
                                            "is_carrier": false,
                                            "update_status": "current",
                                            "optimised_for_mobile": true,
                                            "live_update_allowed": true,
                                            "rating_status": "available",
                                            "rating": 2.89,
                                            "feedback_count": 10524,
                                            "rating_breakdown": {
                                                "reliable_prices": 2.642644,
                                                "clear_extra_fees": 4.037472,
                                                "customer_service": 4.926028,
                                                "ease_of_booking": 3.48266,
                                                "other": 1.475856
                                            }
                                        }
                                    ],
                                    "price": {
                                        "amount": 263.35,
                                        "update_status": "current",
                                        "last_updated": "2022-09-14T17:38:44",
                                        "quote_age": 133
                                    }
                                },
                                {
                                    "agents": [
                                        {
                                            "id": "ytuk",
                                            "name": "Skyscanner",
                                            "is_carrier": false,
                                            "update_status": "current",
                                            "optimised_for_mobile": true,
                                            "live_update_allowed": true,
                                            "rating_status": "available",
                                            "rating": 4.5,
                                            "feedback_count": 6145,
                                            "rating_breakdown": {
                                                "reliable_prices": 4.624616,
                                                "clear_extra_fees": 4.722904,
                                                "customer_service": 5,
                                                "ease_of_booking": 4.739636,
                                                "other": 3.929264
                                            }
                                        }
                                    ],
                                    "price": {
                                        "amount": 265.51,
                                        "update_status": "current",
                                        "last_updated": "2022-09-14T19:44:38",
                                        "quote_age": 7
                                    }
                                },
                                {
                                    "agents": [
                                        {
                                            "id": "s1uk",
                                            "name": "BudgetAir",
                                            "is_carrier": false,
                                            "update_status": "current",
                                            "optimised_for_mobile": true,
                                            "live_update_allowed": true,
                                            "rating_status": "available",
                                            "rating": 3.88,
                                            "feedback_count": 19734,
                                            "rating_breakdown": {
                                                "reliable_prices": 4.048528,
                                                "clear_extra_fees": 4.510536,
                                                "customer_service": 4.811432,
                                                "ease_of_booking": 4.285048,
                                                "other": 2.883328
                                            }
                                        }
                                    ],
                                    "price": {
                                        "amount": 266.41,
                                        "update_status": "current",
                                        "last_updated": "2022-09-14T17:38:49",
                                        "quote_age": 133
                                    }
                                }
                            ]
                        }
                    ]
                }
            }
          
        

API Response Objects:

Response Object Description
results Returns array with flights.
id Returns id of flights.
legs Returns array of objects with information of flight with origin and destination selected.
pricing_options Returns array of pricing options.



Get Location Data


With this Endpoint you can get location_id to be used in Search Hotel Rooms Endpoint and in Search Car Rentals Endpoint

Example API Request:

https://app.goflightlabs.com/get-location-data?access_key=YOUR_ACCESS_KEY&query=berlin

API request example with search parameter

https://app.goflightlabs.com/get-location-data?access_key=YOUR_ACCESS_KEY&query=berlin


HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
query [Required] Use this parameter to get suggestions for hotel location by city.

Example API Response (scrollable):

          

            {
              "success": true,
              "data": [
                  {
                      "hierarchy": "Berlin|Berlin|Germany",
                      "location": "52.366667, 13.50333",
                      "highlight": {
                          "hierarchy": "Berlin|Berlin|Germany",
                          "location_name": "95673383"
                      },
                      "class": "Airport",
                      "location_id": "95673383",
                      "location_name": "Berlin Brandenburg (BER)"
                  },
                  {
                      "hierarchy": "Berlin|Germany",
                      "location": "52.4865621581, 13.4245185552",
                      "highlight": {
                          "hierarchy": "Berlin|Germany",
                          "location_name": "27547053"
                      },
                      "class": "City",
                      "location_id": "27547053",
                      "location_name": "Berlin"
                  },
                  {
                      "hierarchy": "Berlin|Coos County|New Hampshire|United States",
                      "location": "44.574722, -71.176389",
                      "highlight": {
                          "hierarchy": "Berlin|Coos County|New Hampshire|United States",
                          "location_name": "129052940"
                      },
                      "class": "Airport",
                      "location_id": "129052940",
                      "location_name": "Berlin (BML)"
                  },
                  {
                      "hierarchy": "Hartford County|Connecticut|United States",
                      "location": "41.621487992, -72.7456519713",
                      "highlight": {
                          "hierarchy": "Hartford County|Connecticut|United States",
                          "location_name": "35467636"
                      },
                      "class": "City",
                      "location_id": "35467636",
                      "location_name": "Berlin"
                  },
                  {
                      "hierarchy": "Brandenburg|Germany",
                      "location": "52.6739047886, 13.568761033",
                      "highlight": {
                          "hierarchy": "Brandenburg|Germany",
                          "location_name": "81980359"
                      },
                      "class": "City",
                      "location_id": "81980359",
                      "location_name": "Bernau bei Berlin"
                  },
                  {
                      "hierarchy": "Neiva|Huila Department|Colombia",
                      "location": "3.0536110992, -75.4236110947",
                      "highlight": {
                          "hierarchy": "Neiva|Huila Department|Colombia",
                          "location_name": "45789405"
                      },
                      "class": "City",
                      "location_id": "45789405",
                      "location_name": "Berlin"
                  },
                  {
                      "hierarchy": "Marshall County|Tennessee|United States",
                      "location": "35.5297941932, -86.8244448044",
                      "highlight": {
                          "hierarchy": "Marshall County|Tennessee|United States",
                          "location_name": "46824016"
                      },
                      "class": "City",
                      "location_id": "46824016",
                      "location_name": "Berlin"
                  },
                  {
                      "hierarchy": "Worcester County|Massachusetts|United States",
                      "location": "42.3812039914, -71.6370120133",
                      "highlight": {
                          "hierarchy": "Worcester County|Massachusetts|United States",
                          "location_name": "46855770"
                      },
                      "class": "City",
                      "location_id": "46855770",
                      "location_name": "Berlin"
                  },
                  {
                      "hierarchy": "Worcester County|Maryland|United States",
                      "location": "38.3226153929, -75.2176891939",
                      "highlight": {
                          "hierarchy": "Worcester County|Maryland|United States",
                          "location_name": "46793487"
                      },
                      "class": "City",
                      "location_id": "46793487",
                      "location_name": "Berlin"
                  },
                  {
                      "hierarchy": "LaMoure County|North Dakota|United States",
                      "location": "46.3785822928, -98.48981832",
                      "highlight": {
                          "hierarchy": "LaMoure County|North Dakota|United States",
                          "location_name": "46864936"
                      },
                      "class": "City",
                      "location_id": "46864936",
                      "location_name": "Berlin"
                  }
              ]
          }
          
        

API Response Objects:

Response Object Description
data Returns array of results.
hierarchy Returns the city | locality | country .
location Returns the coordinates of the city.
location_name Returns the name of location.
highlight Returns the highlight of entity.
location_id Returns the location id of city to be used in Search Hotel Rooms Endpoint and in Search Car Rentals Endpoint.
class Returns type of result if is Airport or City.



Search Hotel Rooms


Return available hotel rooms.

Example API Request:

https://app.goflightlabs.com/search-hotel-rooms?access_key=YOUR_ACCESS_KEY&locationId=27547053&adults=1&rooms=1&checkin=2023-06-06&checkout=2023-06-11

API request example with search parameter

https://app.goflightlabs.com/search-hotel-rooms?access_key=YOUR_ACCESS_KEY&locationId=27547053&locationId=27547053&adults=1&rooms=1&checkin=2023-06-06&checkout=2023-06-11


HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
adults [Required] number of adult (18 and over) guests (1-10).
rooms [Required] number of rooms (1-5).
locationId [Required] location entity id - it can be obtained via Location Data For Hotel Search.
checkin [Required] checkin date, format YYYY-MM-DD.
checkout [Required] checkout date, format YYYY-MM-DD.
rooms [Required] number of rooms (1-5).
childAge1-childAge5 [Optional] childAge1-childAge5 - ages of children (0-15) guests.
page [Optional] page of results - default: first page is returned.
sortBy [Optional] sort results by, possible values: -relevance, -price, price, distance, -hotel_rating, -stars, stars - default: -relevance.
currency [Optional] currency of hotel prices, default: EUR.

Example API Response: (scrollable)

          
            {
                "success": true,
                "data": {
                    "hotels": [
                        {
                            "hotelId": "104597435",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/767398211/767398211_WxH.jpg",
                            "name": "Grand Hostel Berlin Urban",
                            "stars": 3,
                            "brandIds": [],
                            "distance": "3,89 km from city centre",
                            "relevantPoiDistance": "2.07 km from Tempelhofer Park",
                            "coordinates": [
                                13.4258,
                                52.48752
                            ],
                            "price": "585 €",
                            "cheapestOfferPartnerId": "h_ad",
                            "cheapestOfferRateId": null,
                            "rawPrice": 585,
                            "rating": {
                                "description": "Very good",
                                "count": 614,
                                "value": "8.0",
                                "color": "colorMonteverde"
                            },
                            "reviewSummary": {
                                "description": "Very good",
                                "count": 614,
                                "formatCount": "614",
                                "value": "4.0",
                                "formatValue": "4,0",
                                "color": "colorMonteverde",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-64600-4.png"
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "5 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/767398211/767398211_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/767398213/767398213_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/791664227/791664227_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_hc",
                                    "partnerName": "Hotels.com",
                                    "rawPrice": 627,
                                    "price": "627 €"
                                },
                                {
                                    "partnerId": "h_bc",
                                    "partnerName": "Booking.com",
                                    "rawPrice": 688,
                                    "price": "688 €"
                                },
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 688,
                                    "price": "688 €"
                                },
                                {
                                    "partnerId": "h_ct",
                                    "partnerName": "Trip.com",
                                    "rawPrice": 689,
                                    "price": "689 €"
                                }
                            ],
                            "priceDescription": "195 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [
                                {
                                    "key": "free_cancellation",
                                    "text": "Free cancellation",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    }
                                }
                            ],
                            "cheapestOfferPartnerName": "Agoda"
                        },
                        {
                            "hotelId": "117357901",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/884719305/884719305_WxH.jpg",
                            "name": "Park Inn by Radisson Berlin Alexanderplatz",
                            "stars": 4,
                            "brandIds": [],
                            "distance": "0,17 km from city centre",
                            "relevantPoiDistance": "2.91 km from Berlin Central Station",
                            "coordinates": [
                                13.41293,
                                52.5232
                            ],
                            "price": "2.298 €",
                            "cheapestOfferPartnerId": "h_ct",
                            "cheapestOfferRateId": null,
                            "rawPrice": 2298,
                            "rating": {
                                "description": "Good",
                                "count": 11439,
                                "value": "7.0",
                                "color": "colorKolkata"
                            },
                            "reviewSummary": {
                                "description": "Good",
                                "count": 11439,
                                "formatCount": "11.439",
                                "value": "3.5",
                                "formatValue": "3,5",
                                "color": "colorKolkata",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.5-64600-4.png",
                                "confidenceBadge": {
                                    "type": "location",
                                    "score": 4.5,
                                    "icon": "thumbs-up",
                                    "color": {
                                        "light": "colorMonteverde",
                                        "dark": "colorMonteverde"
                                    },
                                    "message": "Hotel location is rated 4.5/5"
                                }
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "1 price",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/884719305/884719305_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/540318460/540318460_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/475829685/475829685_WxH.jpg"
                            ],
                            "otherRates": [],
                            "priceDescription": "766 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Trip.com"
                        },
                        {
                            "hotelId": "81981751",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/798019037/798019037_WxH.jpg",
                            "name": "City Pension Berlin",
                            "stars": 2,
                            "brandIds": [],
                            "distance": "7,62 km from city centre",
                            "relevantPoiDistance": "2.31 km from Tierpark",
                            "coordinates": [
                                13.3039,
                                52.50565
                            ],
                            "price": "574 €",
                            "cheapestOfferPartnerId": "h_bc",
                            "cheapestOfferRateId": null,
                            "rawPrice": 574,
                            "rating": {
                                "description": "Very good",
                                "count": 95,
                                "value": "8.0",
                                "color": "colorMonteverde"
                            },
                            "reviewSummary": {
                                "description": "Very good",
                                "count": 95,
                                "formatCount": "95",
                                "value": "4.0",
                                "formatValue": "4,0",
                                "color": "colorMonteverde",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-64600-4.png",
                                "confidenceBadge": {
                                    "type": "location",
                                    "score": 4.5,
                                    "icon": "thumbs-up",
                                    "color": {
                                        "light": "colorMonteverde",
                                        "dark": "colorMonteverde"
                                    },
                                    "message": "Hotel location is rated 4.5/5"
                                }
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "3 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/798019037/798019037_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/721648397/721648397_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/798019009/798019009_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 574,
                                    "price": "574 €"
                                },
                                {
                                    "partnerId": "h_ad",
                                    "partnerName": "Agoda",
                                    "rawPrice": 574,
                                    "price": "574 €"
                                }
                            ],
                            "priceDescription": "192 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [
                                {
                                    "key": "breakfast_included",
                                    "text": "Breakfast included",
                                    "color": {
                                        "light": "colorMonteverde",
                                        "dark": "colorMonteverde"
                                    }
                                }
                            ],
                            "cheapestOfferPartnerName": "Booking.com"
                        },
                        {
                            "hotelId": "47005673",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/678947461/678947461_WxH.jpg",
                            "name": "Hotel am Schloß Köpenick by Golden Tulip",
                            "stars": 4,
                            "brandIds": [],
                            "distance": "13,75 km from city centre",
                            "relevantPoiDistance": "1.72 km from Sportplatz Eiche",
                            "coordinates": [
                                13.56953,
                                52.44259
                            ],
                            "price": "650 €",
                            "cheapestOfferPartnerId": "h_ad",
                            "cheapestOfferRateId": null,
                            "rawPrice": 650,
                            "rating": {
                                "description": "Good",
                                "count": 323,
                                "value": "7.0",
                                "color": "colorKolkata"
                            },
                            "reviewSummary": {
                                "description": "Good",
                                "count": 323,
                                "formatCount": "323",
                                "value": "3.5",
                                "formatValue": "3,5",
                                "color": "colorKolkata",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.5-64600-4.png"
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "6 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/678947461/678947461_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/767187908/767187908_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/678947398/678947398_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_zh",
                                    "partnerName": "ZenHotels",
                                    "rawPrice": 687,
                                    "price": "687 €"
                                },
                                {
                                    "partnerId": "h_ct",
                                    "partnerName": "Trip.com",
                                    "rawPrice": 692,
                                    "price": "692 €"
                                },
                                {
                                    "partnerId": "h_hc",
                                    "partnerName": "Hotels.com",
                                    "rawPrice": 704,
                                    "price": "704 €"
                                },
                                {
                                    "partnerId": "h_bc",
                                    "partnerName": "Booking.com",
                                    "rawPrice": 706,
                                    "price": "706 €"
                                },
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 706,
                                    "price": "706 €"
                                }
                            ],
                            "priceDescription": "217 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Agoda"
                        },
                        {
                            "hotelId": "47024884",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/885415561/885415561_WxH.jpg",
                            "name": "Leonardo Royal Hotel Berlin Alexanderplatz",
                            "stars": 4,
                            "brandIds": [],
                            "distance": "0,93 km from city centre",
                            "relevantPoiDistance": "0.92 km from Alexanderplatz",
                            "coordinates": [
                                13.42333,
                                52.52741
                            ],
                            "price": "820 €",
                            "cheapestOfferPartnerId": "h_ad",
                            "cheapestOfferRateId": null,
                            "rawPrice": 820,
                            "rating": {
                                "description": "Very good",
                                "count": 2676,
                                "value": "8.0",
                                "color": "colorMonteverde"
                            },
                            "reviewSummary": {
                                "description": "Very good",
                                "count": 2676,
                                "formatCount": "2.676",
                                "value": "4.0",
                                "formatValue": "4,0",
                                "color": "colorMonteverde",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-64600-4.png",
                                "confidenceBadge": {
                                    "type": "cleanliness",
                                    "score": 4.5,
                                    "icon": "thumbs-up",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    },
                                    "message": "Hotel cleanliness is rated 4.5/5"
                                },
                                "cleanliness": {
                                    "score": 4.5,
                                    "text": "Cleanliness 4,5",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    }
                                }
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "7 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/885415561/885415561_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/626336231/626336231_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/797629239/797629239_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_ct",
                                    "partnerName": "Trip.com",
                                    "rawPrice": 846,
                                    "price": "846 €"
                                },
                                {
                                    "partnerId": "h_zh",
                                    "partnerName": "ZenHotels",
                                    "rawPrice": 934,
                                    "price": "934 €"
                                },
                                {
                                    "partnerId": "h_hc",
                                    "partnerName": "Hotels.com",
                                    "rawPrice": 986,
                                    "price": "986 €"
                                },
                                {
                                    "partnerId": "h_pi",
                                    "partnerName": "Prestigia",
                                    "rawPrice": 986,
                                    "price": "986 €"
                                },
                                {
                                    "partnerId": "h_bc",
                                    "partnerName": "Booking.com",
                                    "rawPrice": 989,
                                    "price": "989 €"
                                },
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 989,
                                    "price": "989 €"
                                }
                            ],
                            "priceDescription": "274 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Agoda"
                        },
                        {
                            "hotelId": "118138611",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/720408331/720408331_WxH.jpg",
                            "name": "Steigenberger Hotel Am Kanzleramt",
                            "stars": 5,
                            "brandIds": [
                                "90718601"
                            ],
                            "distance": "3,06 km from city centre",
                            "relevantPoiDistance": "0.17 km from Berlin Central Station",
                            "coordinates": [
                                13.36818,
                                52.52389
                            ],
                            "price": "1.132 €",
                            "cheapestOfferPartnerId": "h_ad",
                            "cheapestOfferRateId": null,
                            "rawPrice": 1132,
                            "rating": {
                                "description": "Excellent",
                                "count": 5180,
                                "value": "9.0",
                                "color": "colorMonteverde"
                            },
                            "reviewSummary": {
                                "description": "Excellent",
                                "count": 5180,
                                "formatCount": "5.180",
                                "value": "4.5",
                                "formatValue": "4,5",
                                "color": "colorMonteverde",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.5-64600-4.png",
                                "confidenceBadge": {
                                    "type": "cleanliness",
                                    "score": 4.5,
                                    "icon": "thumbs-up",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    },
                                    "message": "Hotel cleanliness is rated 4.5/5"
                                },
                                "cleanliness": {
                                    "score": 4.5,
                                    "text": "Cleanliness 4,5",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    }
                                }
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "8 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/720408331/720408331_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/479080044/479080044_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/756238280/756238280_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_ct",
                                    "partnerName": "Trip.com",
                                    "rawPrice": 1174,
                                    "price": "1.174 €"
                                },
                                {
                                    "partnerId": "h_hc",
                                    "partnerName": "Hotels.com",
                                    "rawPrice": 1190,
                                    "price": "1.190 €"
                                },
                                {
                                    "partnerId": "h_pi",
                                    "partnerName": "Prestigia",
                                    "rawPrice": 1190,
                                    "price": "1.190 €"
                                },
                                {
                                    "partnerId": "h_bc",
                                    "partnerName": "Booking.com",
                                    "rawPrice": 1193,
                                    "price": "1.193 €"
                                },
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 1193,
                                    "price": "1.193 €"
                                },
                                {
                                    "partnerId": "h_df",
                                    "partnerName": "Derbysoft CPA",
                                    "rawPrice": 1193,
                                    "price": "1.193 €"
                                },
                                {
                                    "partnerId": "h_zh",
                                    "partnerName": "ZenHotels",
                                    "rawPrice": 1565,
                                    "price": "1.565 €"
                                }
                            ],
                            "priceDescription": "378 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Agoda"
                        },
                        {
                            "hotelId": "46946476",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/756493656/756493656_WxH.jpg",
                            "name": "Pentahotel Berlin Köpenick",
                            "stars": 4,
                            "brandIds": [],
                            "distance": "13,65 km from city centre",
                            "relevantPoiDistance": "1.67 km from Sportplatz Eiche",
                            "coordinates": [
                                13.56946,
                                52.44405
                            ],
                            "price": "648 €",
                            "cheapestOfferPartnerId": "h_ad",
                            "cheapestOfferRateId": null,
                            "rawPrice": 648,
                            "rating": {
                                "description": "Very good",
                                "count": 2,
                                "value": "8.6",
                                "color": "colorMonteverde"
                            },
                            "reviewSummary": {
                                "description": "Excellent",
                                "count": 2,
                                "formatCount": "2",
                                "value": "4.3",
                                "formatValue": "4,3",
                                "color": "colorMonteverde",
                                "taImage": null
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "5 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/756493656/756493656_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/846221229/846221229_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/756493726/756493726_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_hc",
                                    "partnerName": "Hotels.com",
                                    "rawPrice": 790,
                                    "price": "790 €"
                                },
                                {
                                    "partnerId": "h_bc",
                                    "partnerName": "Booking.com",
                                    "rawPrice": 881,
                                    "price": "881 €"
                                },
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 881,
                                    "price": "881 €"
                                },
                                {
                                    "partnerId": "h_ct",
                                    "partnerName": "Trip.com",
                                    "rawPrice": 881,
                                    "price": "881 €"
                                }
                            ],
                            "priceDescription": "216 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Agoda"
                        },
                        {
                            "hotelId": "46980715",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/353065567/353065567_WxH.jpg",
                            "name": "Vienna House Andel's Berlin",
                            "stars": 4,
                            "brandIds": [
                                "90718630"
                            ],
                            "distance": "3,08 km from city centre",
                            "relevantPoiDistance": "2.69 km from Haus des Lehrers",
                            "coordinates": [
                                13.45736,
                                52.52856
                            ],
                            "price": "757 €",
                            "cheapestOfferPartnerId": "h_ad",
                            "cheapestOfferRateId": null,
                            "rawPrice": 757,
                            "rating": {
                                "description": "Excellent",
                                "count": 3179,
                                "value": "9.0",
                                "color": "colorMonteverde"
                            },
                            "reviewSummary": {
                                "description": "Excellent",
                                "count": 3179,
                                "formatCount": "3.179",
                                "value": "4.5",
                                "formatValue": "4,5",
                                "color": "colorMonteverde",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.5-64600-4.png",
                                "confidenceBadge": {
                                    "type": "cleanliness",
                                    "score": 4.5,
                                    "icon": "thumbs-up",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    },
                                    "message": "Hotel cleanliness is rated 4.5/5"
                                },
                                "cleanliness": {
                                    "score": 4.5,
                                    "text": "Cleanliness 4,5",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    }
                                }
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "6 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/353065567/353065567_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/766308939/766308939_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/676746400/676746400_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_bc",
                                    "partnerName": "Booking.com",
                                    "rawPrice": 800,
                                    "price": "800 €"
                                },
                                {
                                    "partnerId": "h_hc",
                                    "partnerName": "Hotels.com",
                                    "rawPrice": 800,
                                    "price": "800 €"
                                },
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 800,
                                    "price": "800 €"
                                },
                                {
                                    "partnerId": "h_pi",
                                    "partnerName": "Prestigia",
                                    "rawPrice": 800,
                                    "price": "800 €"
                                },
                                {
                                    "partnerId": "h_ct",
                                    "partnerName": "Trip.com",
                                    "rawPrice": 833,
                                    "price": "833 €"
                                }
                            ],
                            "priceDescription": "253 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Agoda"
                        },
                        {
                            "hotelId": "123708745",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/776543855/776543855_WxH.jpg",
                            "name": "Best Western Plus Plaza Berlin Kurfuerstendamm",
                            "stars": 4,
                            "brandIds": [
                                "90718297"
                            ],
                            "distance": "6,49 km from city centre",
                            "relevantPoiDistance": "1.20 km from Tierpark",
                            "coordinates": [
                                13.32313,
                                52.50188
                            ],
                            "price": "883 €",
                            "cheapestOfferPartnerId": "h_ct",
                            "cheapestOfferRateId": null,
                            "rawPrice": 883,
                            "rating": {
                                "description": "Very good",
                                "count": 680,
                                "value": "8.0",
                                "color": "colorMonteverde"
                            },
                            "reviewSummary": {
                                "description": "Very good",
                                "count": 680,
                                "formatCount": "680",
                                "value": "4.0",
                                "formatValue": "4,0",
                                "color": "colorMonteverde",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-64600-4.png",
                                "confidenceBadge": {
                                    "type": "location",
                                    "score": 4.5,
                                    "icon": "thumbs-up",
                                    "color": {
                                        "light": "colorMonteverde",
                                        "dark": "colorMonteverde"
                                    },
                                    "message": "Hotel location is rated 4.5/5"
                                }
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "1 price",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/776543855/776543855_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/885520318/885520318_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/677039326/677039326_WxH.jpg"
                            ],
                            "otherRates": [],
                            "priceDescription": "295 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Trip.com"
                        },
                        {
                            "hotelId": "46965268",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/685200851/685200851_WxH.jpg",
                            "name": "Airporthotel Berlin-Adlershof",
                            "stars": 3,
                            "brandIds": [],
                            "distance": "12,88 km from city centre",
                            "relevantPoiDistance": null,
                            "coordinates": [
                                13.5346519,
                                52.4323981
                            ],
                            "price": "639 €",
                            "cheapestOfferPartnerId": "h_hc",
                            "cheapestOfferRateId": null,
                            "rawPrice": 639,
                            "rating": {
                                "description": "Good",
                                "count": 128,
                                "value": "7.0",
                                "color": "colorKolkata"
                            },
                            "reviewSummary": {
                                "description": "Good",
                                "count": 128,
                                "formatCount": "128",
                                "value": "3.5",
                                "formatValue": "3,5",
                                "color": "colorKolkata",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.5-64600-4.png",
                                "confidenceBadge": {
                                    "type": "cleanliness",
                                    "score": 4.5,
                                    "icon": "thumbs-up",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    },
                                    "message": "Hotel cleanliness is rated 4.5/5"
                                }
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "6 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/685200851/685200851_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/685200722/685200722_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/685200821/685200821_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_ad",
                                    "partnerName": "Agoda",
                                    "rawPrice": 652,
                                    "price": "652 €"
                                },
                                {
                                    "partnerId": "h_ct",
                                    "partnerName": "Trip.com",
                                    "rawPrice": 709,
                                    "price": "709 €"
                                },
                                {
                                    "partnerId": "h_bc",
                                    "partnerName": "Booking.com",
                                    "rawPrice": 740,
                                    "price": "740 €"
                                },
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 740,
                                    "price": "740 €"
                                },
                                {
                                    "partnerId": "h_zh",
                                    "partnerName": "ZenHotels",
                                    "rawPrice": 758,
                                    "price": "758 €"
                                }
                            ],
                            "priceDescription": "213 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Hotels.com"
                        },
                        {
                            "hotelId": "129852394",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/578592363/578592363_WxH.jpg",
                            "name": "Qbe Hotel Heizhaus Berlin",
                            "stars": 3,
                            "brandIds": [],
                            "distance": "7,68 km from city centre",
                            "relevantPoiDistance": "2.89 km from Dong Xuan Center",
                            "coordinates": [
                                13.52618,
                                52.51459
                            ],
                            "price": "628 €",
                            "cheapestOfferPartnerId": "h_ad",
                            "cheapestOfferRateId": null,
                            "rawPrice": 628,
                            "rating": {
                                "description": "Good",
                                "count": 117,
                                "value": "7.0",
                                "color": "colorKolkata"
                            },
                            "reviewSummary": {
                                "description": "Good",
                                "count": 117,
                                "formatCount": "117",
                                "value": "3.5",
                                "formatValue": "3,5",
                                "color": "colorKolkata",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.5-64600-4.png"
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "3 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/578592363/578592363_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/578592370/578592370_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/578592341/578592341_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_bc",
                                    "partnerName": "Booking.com",
                                    "rawPrice": 698,
                                    "price": "698 €"
                                },
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 698,
                                    "price": "698 €"
                                }
                            ],
                            "priceDescription": "210 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Agoda"
                        },
                        {
                            "hotelId": "47005674",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/468174153/468174153_WxH.jpg",
                            "name": "Best Western Hotel am Spittelmarkt Berlin",
                            "stars": 3,
                            "brandIds": [
                                "90718297"
                            ],
                            "distance": "1,40 km from city centre",
                            "relevantPoiDistance": "2.92 km from Berlin Central Station",
                            "coordinates": [
                                13.40554,
                                52.51001
                            ],
                            "price": "743 €",
                            "cheapestOfferPartnerId": "h_ct",
                            "cheapestOfferRateId": null,
                            "rawPrice": 743,
                            "rating": {
                                "description": "Very good",
                                "count": 2104,
                                "value": "8.0",
                                "color": "colorMonteverde"
                            },
                            "reviewSummary": {
                                "description": "Very good",
                                "count": 2104,
                                "formatCount": "2.104",
                                "value": "4.0",
                                "formatValue": "4,0",
                                "color": "colorMonteverde",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-64600-4.png",
                                "confidenceBadge": {
                                    "type": "cleanliness",
                                    "score": 4.5,
                                    "icon": "thumbs-up",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    },
                                    "message": "Hotel cleanliness is rated 4.5/5"
                                },
                                "cleanliness": {
                                    "score": 4.5,
                                    "text": "Cleanliness 4,5",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    }
                                }
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "5 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/468174153/468174153_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/540318893/540318893_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/678730280/678730280_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_hc",
                                    "partnerName": "Hotels.com",
                                    "rawPrice": 767,
                                    "price": "767 €"
                                },
                                {
                                    "partnerId": "h_bc",
                                    "partnerName": "Booking.com",
                                    "rawPrice": 770,
                                    "price": "770 €"
                                },
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 770,
                                    "price": "770 €"
                                },
                                {
                                    "partnerId": "h_ad",
                                    "partnerName": "Agoda",
                                    "rawPrice": 770,
                                    "price": "770 €"
                                }
                            ],
                            "priceDescription": "248 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Trip.com"
                        },
                        {
                            "hotelId": "46991985",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/776354322/776354322_WxH.jpg",
                            "name": "Hotel Atrium Charlottenburg",
                            "stars": 3,
                            "brandIds": [],
                            "distance": "7,72 km from city centre",
                            "relevantPoiDistance": "2.42 km from Tierpark",
                            "coordinates": [
                                13.3022,
                                52.506
                            ],
                            "price": "603 €",
                            "cheapestOfferPartnerId": "h_bc",
                            "cheapestOfferRateId": null,
                            "rawPrice": 603,
                            "rating": {
                                "description": "Good",
                                "count": 260,
                                "value": "7.0",
                                "color": "colorKolkata"
                            },
                            "reviewSummary": {
                                "description": "Good",
                                "count": 260,
                                "formatCount": "260",
                                "value": "3.5",
                                "formatValue": "3,5",
                                "color": "colorKolkata",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.5-64600-4.png"
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "3 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/776354322/776354322_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/756793262/756793262_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/716071100/716071100_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 603,
                                    "price": "603 €"
                                },
                                {
                                    "partnerId": "h_ad",
                                    "partnerName": "Agoda",
                                    "rawPrice": 603,
                                    "price": "603 €"
                                }
                            ],
                            "priceDescription": "201 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Booking.com"
                        },
                        {
                            "hotelId": "114941752",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/884122288/884122288_WxH.jpg",
                            "name": "Seminaris CampusHotel Berlin",
                            "stars": 4,
                            "brandIds": [],
                            "distance": "10,88 km from city centre",
                            "relevantPoiDistance": "0.17 km from Free University of Berlin",
                            "coordinates": [
                                13.29475,
                                52.45566
                            ],
                            "price": "785 €",
                            "cheapestOfferPartnerId": "h_ad",
                            "cheapestOfferRateId": null,
                            "rawPrice": 785,
                            "rating": {
                                "description": "With honours",
                                "count": 5,
                                "value": "10.0",
                                "color": "colorMonteverde"
                            },
                            "reviewSummary": {
                                "description": "With honours",
                                "count": 5,
                                "formatCount": "5",
                                "value": "5.0",
                                "formatValue": "5,0",
                                "color": "colorMonteverde",
                                "taImage": null,
                                "confidenceBadge": {
                                    "type": "cleanliness",
                                    "score": 5,
                                    "icon": "thumbs-up",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    },
                                    "message": "Hotel cleanliness is rated 5/5"
                                }
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "6 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/884122288/884122288_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/685242731/685242731_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/797666910/797666910_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_hc",
                                    "partnerName": "Hotels.com",
                                    "rawPrice": 806,
                                    "price": "806 €"
                                },
                                {
                                    "partnerId": "h_zh",
                                    "partnerName": "ZenHotels",
                                    "rawPrice": 880,
                                    "price": "880 €"
                                },
                                {
                                    "partnerId": "h_ct",
                                    "partnerName": "Trip.com",
                                    "rawPrice": 925,
                                    "price": "925 €"
                                },
                                {
                                    "partnerId": "h_bc",
                                    "partnerName": "Booking.com",
                                    "rawPrice": 987,
                                    "price": "987 €"
                                },
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 987,
                                    "price": "987 €"
                                }
                            ],
                            "priceDescription": "262 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [
                                {
                                    "key": "breakfast_included",
                                    "text": "Breakfast included",
                                    "color": {
                                        "light": "colorMonteverde",
                                        "dark": "colorMonteverde"
                                    }
                                }
                            ],
                            "cheapestOfferPartnerName": "Agoda"
                        },
                        {
                            "hotelId": "47026369",
                            "heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/884124234/884124234_WxH.jpg",
                            "name": "Mövenpick Hotel Berlin",
                            "stars": 4,
                            "brandIds": [],
                            "distance": "2,99 km from city centre",
                            "relevantPoiDistance": "2.46 km from Berlin Central Station",
                            "coordinates": [
                                13.3804410696,
                                52.5037399316
                            ],
                            "price": "1.214 €",
                            "cheapestOfferPartnerId": "h_ct",
                            "cheapestOfferRateId": null,
                            "rawPrice": 1214,
                            "rating": {
                                "description": "Excellent",
                                "count": 2839,
                                "value": "9.0",
                                "color": "colorMonteverde"
                            },
                            "reviewSummary": {
                                "description": "Excellent",
                                "count": 2839,
                                "formatCount": "2.839",
                                "value": "4.5",
                                "formatValue": "4,5",
                                "color": "colorMonteverde",
                                "taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.5-64600-4.png",
                                "confidenceBadge": {
                                    "type": "cleanliness",
                                    "score": 4.5,
                                    "icon": "thumbs-up",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    },
                                    "message": "Hotel cleanliness is rated 4.5/5"
                                },
                                "cleanliness": {
                                    "score": 4.5,
                                    "text": "Cleanliness 4,5",
                                    "color": {
                                        "light": "colorAbisko",
                                        "dark": "colorValensole"
                                    }
                                }
                            },
                            "cheapestOffer": "meta",
                            "offerTypes": "meta",
                            "guestType": null,
                            "exclusiveDealLabel": null,
                            "pricesFrom": "7 prices from",
                            "images": [
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/884124234/884124234_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/754872707/754872707_WxH.jpg",
                                "https://d2xf5gjipzd8cd.cloudfront.net/available/884124409/884124409_WxH.jpg"
                            ],
                            "otherRates": [
                                {
                                    "partnerId": "h_ad",
                                    "partnerName": "Agoda",
                                    "rawPrice": 1227,
                                    "price": "1.227 €"
                                },
                                {
                                    "partnerId": "h_zh",
                                    "partnerName": "ZenHotels",
                                    "rawPrice": 1250,
                                    "price": "1.250 €"
                                },
                                {
                                    "partnerId": "h_hc",
                                    "partnerName": "Hotels.com",
                                    "rawPrice": 1284,
                                    "price": "1.284 €"
                                },
                                {
                                    "partnerId": "h_pi",
                                    "partnerName": "Prestigia",
                                    "rawPrice": 1284,
                                    "price": "1.284 €"
                                },
                                {
                                    "partnerId": "h_bc",
                                    "partnerName": "Booking.com",
                                    "rawPrice": 1288,
                                    "price": "1.288 €"
                                },
                                {
                                    "partnerId": "h_io",
                                    "partnerName": "Opodo",
                                    "rawPrice": 1288,
                                    "price": "1.288 €"
                                }
                            ],
                            "priceDescription": "405 € a night",
                            "taxPolicy": "All taxes and fees included",
                            "rateFeatures": [],
                            "cheapestOfferPartnerName": "Trip.com"
                        }
                    ],
                    "nightsForPrice": "For 3 nights",
                    "resultsSummary": "232 results sorted by Best",
                    "closedUserGroupDeals": [
                        "general"
                    ],
                    "pricePolicy": "All taxes and fees included",
                    "mapBoundary": {
                        "n_e_lat": 52.539137808999996,
                        "s_w_lat": 52.4111463201,
                        "n_e_lng": 13.5805212,
                        "s_w_lng": 13.283758800000001
                    },
                    "hotelPivot": null,
                    "medianMinPrice": 1057.5,
                    "entity": {
                        "name": "Berlin",
                        "entity_id": "27547053",
                        "centroid": {
                            "type": "Point",
                            "coordinates": [
                                13.4245185552,
                                52.4865621581
                            ]
                        },
                        "entity_type": "City",
                        "official_center": {
                            "type": "Point",
                            "coordinates": [
                                13.413333,
                                52.521667
                            ]
                        },
                        "levelOfEntityType": "PoliticalTypes"
                    },
                    "location": [
                        {
                            "entity_type": "FirstLevelNationAdministrativeDivision",
                            "name": "Berlin",
                            "entity_id": "44293353"
                        },
                        {
                            "entity_type": "Nation",
                            "name": "Germany",
                            "entity_id": "29475381"
                        }
                    ],
                    "priceType": "total",
                    "localCurrency": "EUR",
                    "hotelsRegion": {
                        "latitude": 52.50804,
                        "longitude": 13.38063,
                        "longitudeDelta": 0.16145999999999905,
                        "latitudeDelta": 0.0490399999999953
                    },
                    "totalHotels": 232,
                    "totalHotelsFiltered": 232,
                    "pois": [
                        {
                            "type": "Transportation",
                            "coordinate": [
                                13.50333,
                                52.366667
                            ],
                            "sub_poi_type": "Airport",
                            "name": "Berlin Brandenburg",
                            "image_url": null,
                            "is_extend": null,
                            "id": 95673383
                        },
                        {
                            "type": "Transportation",
                            "coordinate": [
                                13.3699998498,
                                52.5249761108
                            ],
                            "sub_poi_type": "TrainStation",
                            "name": "Berlin Central Station",
                            "image_url": null,
                            "is_extend": null,
                            "id": 207975909
                        },
                        {
                            "type": "Landmark",
                            "coordinate": [
                                13.40568,
                                52.57838
                            ],
                            "sub_poi_type": "TouristAttraction",
                            "name": "Schloss Schoenhausen",
                            "image_url": null,
                            "is_extend": null,
                            "id": 206563816
                        },
                        {
                            "type": "Landmark",
                            "coordinate": [
                                13.3777041,
                                52.5162746
                            ],
                            "sub_poi_type": "TouristAttraction",
                            "name": "Brandenburg Gate",
                            "image_url": "https://d2xf5gjipzd8cd.cloudfront.net/POI/206569366/1737748/1737748_WxH.jpg",
                            "is_extend": null,
                            "id": 206569366
                        },
                        {
                            "type": "Shopping",
                            "coordinate": [
                                13.412396,
                                52.522513000000004
                            ],
                            "sub_poi_type": "ShoppingMall",
                            "name": "Alexanderplatz",
                            "image_url": "https://d2xf5gjipzd8cd.cloudfront.net/POI/207971440/2870212/2870212_WxH.jpg",
                            "is_extend": null,
                            "id": 207971440
                        }
                    ],
                    "discountAnalysis": {
                        "couponHotels": [],
                        "couponRanks": [],
                        "couponAmounts": [],
                        "discountPercentage": null,
                        "couponType": null,
                        "hasCugDeal": false
                    },
                    "outBoundIndex": -1,
                    "partners": [
                        "Booking.com",
                        "Trip.com",
                        "Hotels.com",
                        "Hyatt",
                        "IHG"
                    ],
                    "requestId": "a291aaaf-a27a-424d-8473-d0065fc3e79d",
                    "searchByCurrentLocation": false,
                    "context": {
                        "completionPercentage": 100,
                        "status": "complete",
                        "searchId": "2ac8530ee8eb3378b229b5591e763c1eb5f8e004217af51ab2576cb4b9217b0f"
                    }
                }
            }
          
        


Search car rentals


Return available car rentals.

Example API Request:

https://app.goflightlabs.com/search-rent-a-car?access_key=YOUR_ACCESS_KEY&pickupId=27547053&pickupDate=2023-06-06&pickupTime=10:30&returnDate=2023-06-11&returnTime=13:00

API request example with search parameter

https://app.goflightlabs.com/search-rent-a-car?access_key=YOUR_ACCESS_KEY&pickupId=27547053&pickupDate=2023-06-06&pickupTime=10:30&returnDate=2023-06-11&returnTime=13:00


HTTP GET Request Parameters:

Object Description
access_key [Required] Your API access key, which can be found in your acccount dashboard.
pickupId [Required] pickup location, location id - it can be obtained via get-location-data.
pickupDate [Required] pickup date, format YYYY-MM-DD.
pickupTime [Required] pickup time, format HH:mm.
returnDate [Required] return date, format YYYY-MM-DD.
returnTime [Required] return time, format HH:mm.
returnId [Optional] return location, location id - it can be obtained via get-location-data - if omitted, car is returned to pickup location.
driverAge [Optional] enter if the driver is less than 25 or over 75 years old.
currency [Optional] currency of hotel prices, default: EUR.

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()
                                  
              

Copyright © 2023 FlightLabs . All rights reserved. Hand-crafted & made with in London