a unique partner ID (affilid). A text or number value given by our affiliate manager.

interface language. International language code (en, cs, es, etc).

interface currency. International currency code (czk, eur, usd, gbp, etc).

number of passengers. A single number value. adults=1&children=1&infants=1 can also be used to get more detailed information.

will add a sub2 parameter to affilid e.g. affilid=partner_de. It should be a two letter ISO country code (de. au, ru)

SubIds

Kiwi api ID of the departure location.

It accepts multiple values separated by comma, these values might be airport codes, city IDs, two letter country codes, metropolitan codes and radiuses as well as subdivision, region, autonomous_territory, continent and specials (Points of interest, such as Times Square).

Some locations have the same code for airport and metropolis (city), e.g. DUS stands for metro code Duesseldorf, Moenchengladbach and Weeze as well as Duesseldorf airport. See the following examples:

• fly_from=city:DUS will match all airports in “DUS”, “MGL” and “NRN” (all in the city of Duesseldorf)

• fly_from=DUS will do the same as the above

• fly_from=airport:DUS will only match airport “DUS” Radius needs to be in form lat-lon-xkm. The number of decimal places for radius is limited to 6. E.g.-23.24--47.86-500km for places around Sao Paulo. ‘LON’ - checks every airport in London, ‘LHR’ - checks flights from London Heathrow, ‘UK’ - flights from the United Kingdom. Link to Locations API. Previous name: from

Kiwi api ID of the arrival destination. It accepts the same values in the same format as the origin parameter. Previous name: to.

If you don’t include any value you’ll get results for all airports in the world.

date of departure. A single date number value (2016-06-30) or a date range value (2016-06-30_2016-07-15). The format is expected in YYYY-MM-DD.

date of return. A single date number value (2016-06-30) or a date range value (2016-06-30_2016-07-15). The format is expected in YYYY-MM-DD. Number of nights of stay can also be used - Only or a range of values (2-10, 4-7,…), for a single value use (5-5, 7-7,…). no-return is recommended to be used when there is no return date. This is preferred to leaving this parameter blank.

‘true’ - only returns results belonging to the selected class; ‘false’ - means that mixed classes are applied (cabinClass=business-false).

Choices: business-true first-true premium-true business-false first-false premium-false

this parameter specifies the means of transport. For multiple values, please use , (comma) as a separator (aircraft,bus). If no specification is specified, all transport options are returned.

Choices: bus aircraft train

this parameter is used to specify the maximum number of stops allowed. If left without specification, any number of stops will be included in the search results.

the maximum length of flight in hours

maximum length of the stopover duration in hours

minimum length of the stopover duration in hours

use this parameter to narrow down the departure and arrival times. The first set of two numbers 4-16 is for the departure. The second (5-18) is the time range of arrival. Every other set of 2 integers means that the Apply for return check box is set. This is specified by underscore 4-16-5-18_6-18-9-22. (departure times of outbound flight - arrival times of outbound flight _ departure times of inbound flight - arrival times of inbound flight)

selected days writen in integers starting from 0 which stands for Sunday. Should the return box be selected, a dash - is used.

this parameter is used to specify the maximum price in EUR for the itinerary. Together with the priceMin a range is created and used.

this parameter is used to specify the minimum price in EUR for the itinerary. Together with the priceMax a range is created and used.

switch for no bag itineraries. Use false to filter out flights that do not include bags.

this parameter accepts airline IATA codes separated by comma and is used with the selectedAirlinesExclude parameter to either include or exclude these airlines in the search.

If false is used, the airlines from the ‘airlineList’ are shown. If true is used, the airlines from the ‘airlineList’ are not included.

this parameter accepts airport IATA codes separated by comma and is used with the selectedStopoverAirportsExclude parameter to either include or exclude these airports in the search.

If false is used, the airports from the ‘airportsList’ are shown. If true is used, the airports from the ‘airportsList’ are not included.

Use this parameter to allow a return from a different airport. ‘False’ = do not allow a return from a different airport. ‘True’ = do allow a return from a different airport.

Use this parameter to allow a return to a different airport. ‘False’ = do not allow a return to a different airport. ‘True’ = do allow a return to a different airport.

Use this parameter to allow overnight stopovers - stopover longer than 4 hours. ‘False’ = do not allow overnight stopovers. ‘True’ = do allow overnight stopovers.

The Nomad is also referred to as Salesman.

When you use Multicity or Nomad parameters, do not use from, to, departure and return.

The Nomad was created for those travelers, who would like to visit n-number of cities in any order. A time restriction is not mandatory. At the moment n = 10. It is fully functional in API. The Nomad parameter contains the values for destination, date_range and time_of_stay.

Links always start with www.kiwi.com/deep?nomad=. The link contains the Nomad segment (the from / to / departure / return) and is followed by up to 10 via destinations. The Nomad segment is of form destination~date_range~time_of_stay. Individual segments are separated by ; and their order is: from;to;via1;via2;via3,via4,…, via10 -> example: JFK~2018-07-28_2018-08-03~--;LGA~2018-07-28_2018-08-03~--;PRG~--~3-9 which means that for those dates I want for fly from JFK, return to LGA and go via Prague and stay there for 3-9 days.

brno_cz~2018-08-18~--%3Bsplit_hr~2018-12-21~-- is the format to use instead of specifying the from. to, departure and return.

• destination (optional, string, STN) … Destination of arrival (case sensitive! Must be capital letters). Either an international code of the airport (PRG, FCO, STN,…), a country code (GB, HR, IT,…), or a city with a country (LONDON_GB, PRAGUE_CZ, ROME_IT,…). If left blank, nothing defaults in.

• date_range (optional, string, 2018-07-28 - 2018-09-03) … if left blank, the default value is today plus one month.

• time_of_stay (optional, string, ‘4-8’) … if left blank, 3-5 days is used as default.

• nomad_stopNumber (optional, number, 1) … For Nomad only: This parameter is used to specify the number of stops. If left without specification, any number of stops will be returned in the search results.

• nomad_noBags (optional, Boolean, true) … For Nomad only: Use this parameter to include or exclude ‘no bag itineraries’. ‘True’ = include no bag itineraries. ‘False’ = do not include no bag itineraries.

When you use Multicity or Salesman parameters, do not use from, to, departure and return.

• origin (required, string,CZ) … Kiwi api ID of the departure location.

  It accepts multiple values separated by comma, these values might be airport codes, city IDs, two letter country codes, metropolitan codes and radiuses as well as subdivision, region, autonomous_territory, continent and specials (Points of interest, such as Times Square).

  Some locations have the same code for airport and metropolis (city), e.g. DUS stands for metro code Duesseldorf, Moenchengladbach and Weeze as well as Duesseldorf airport. See the following examples:

  • fly_from=city:DUS will match all airports in “DUS”, “MGL” and “NRN” (all in the city of Duesseldorf)
  • fly_from=DUS will do the same as the above
  • fly_from=airport:DUS will only match airport “DUS” Radius needs to be in form lat-lon-xkm. The number of decimal places for radius is limited to 6. E.g.-23.24--47.86-500km for places around Sao Paulo. ‘LON’ - checks every airport in London, ‘LHR’ - checks flights from London Heathrow, ‘UK’ - flights from the United Kingdom. Link to Locations API. Previous name: from

• multicity_noBags (optional, Boolean, true) … For Multicity only: Use this parameter to include or exclude ‘no bag itineraries’. ‘True’ = include no bag itineraries. ‘False’ = do not include no bag itineraries.

• multicity_transport (optional, string, bus) … this parameter specifies the means of transport. For multiple values, please use , (comma) as a separator (aircraft,bus). If no specification is specified, all transport options are returned.

  • Values
    • bus
    • aircraft
    • train

• multicity_stopNumber (optional, number, 1) … For Multicity only: This parameter is used to specify the number of stops. If left without specification, any number of stops will be returned in the search results.

• destination (optional, string, porto) … Kiwi api ID of the arrival destination. It accepts the same values in the same format as the fly_from parameter. Previous name: to.

  If you don’t include any value you’ll get results for all airports in the world.
  
  

• date_range (optional, string, 2018-07-28 - 2018-09-03) … if left blank, the default value is today plus one month.