/shopping/flight-destinations

Find the cheapest destinations where you can fly to.

• origin (query, required) — IATA code of the city from which the flight will depart [IATA table codes](http://www.iata.org/publications/Pages/code-search.aspx) - e.g. MAD for Madrid
• departureDate (query) — The date, or range of dates, on which the flight will depart from the origin. Dates are specified in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-DD format, e.g. 2017-12-25. Ranges are specified with a comma and are inclusive Departure date can not be more than 180 days in the future.
• oneWay (query) — if this parameter is set to true, only one-way flights are considered. If this parameter is not set or set to false, only round-trip flights are considered
• duration (query) — Exact duration or range of durations of the travel, in days. This parameter must not be set if oneWay is true. Ranges are specified with a comma and are inclusive, e.g. 2,8 Duration can not be lower than 1 days or higher than 15 days
• nonStop (query) — if this parameter is set to true, only flights going from the origin to the destination with no stop in-between are considered
• maxPrice (query) — defines the price limit for each offer returned. The value should be a positive number, without decimals
• viewBy (query) — view the flight destinations by DATE, DESTINATION, DURATION, WEEK, or COUNTRY. View by DATE (default when oneWay is true) to get the cheapest flight destination for every departure date in the given range. View by DURATION (default when oneWay is false) to get the cheapest flight destination for every departure date and for every duration in the given ranges. View by WEEK to get the cheapest flight destination for every week in the given range of departure dates. View by COUNTRY to get the cheapest flight destination by country. Note that specifying a detailed view but large ranges may result in a huge number of flight destinations being returned. For some very large numbers of flight destinations, the API may refuse to provide a response