---
title: "Find the cheapest destinations where you can fly to."
method: GET
path: "/shopping/flight-destinations"
tags: ["flight-destinations"]
---

# Find the cheapest destinations where you can fly to.

`GET /shopping/flight-destinations`

## Query parameters

- `origin` string, required
- `departureDate` string
- `oneWay` boolean
- `duration` string
- `nonStop` boolean
- `maxPrice` integer
- `viewBy` 'COUNTRY' | 'DATE' | 'DESTINATION' | 'DURATION' | 'WEEK'

## Response `200`

Success

- FlightDestinations
  - `data` FlightDestination[]
    - `type` string — the resource name
    - `origin` string
    - `destination` string
    - `departureDate` string
    - `returnDate` string
    - `price` Price
      - `total` string — Total amount paid by the user
    - `links` object
      - `flightDates` string
      - `flightOffers` string
  - `dictionaries` Dictionaries
    - `currencies` unknown
    - `locations` unknown
  - `meta` Meta
    - `currency` string — the currency in which the prices of the flight offers are returned. Currency is specified in the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format, e.g. EUR for Euro
    - `links` Links
      - `self` string, uri
    - `defaults` Defaults — the query parameters for which default values were used are returned here
      - `departureDate` string — 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
      - `oneWay` boolean — 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` string — 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
      - `nonStop` boolean — if this parameter is set to true, only flights going from the origin to the destination with no stop in-between are considered
      - `viewBy` 'COUNTRY' | 'DATE' | 'DESTINATION' | 'DURATION' | 'WEEK' — view the flight destinations by COUNTRY, DATE, DESTINATION, DURATION, or WEEK. View by COUNTRY to get the cheapest flight dates for every country in the given range. View by DATE to get the cheapest flight dates for every departure date in the given range. View by DURATION to get the cheapest flight dates 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
  - `warnings` Issue[]
    - `status` integer — the HTTP status code applicable to this error
    - `code` integer — an application-specific error code
    - `title` string — a short summary of the error
    - `detail` string — explanation of the error
    - `source` object — an object containing references to the source of the error
      - `pointer` string — a JSON Pointer [RFC6901] to the associated entity in the request document
      - `parameter` string — a string indicating which URI query parameter caused the issue
      - `example` string — a string indicating an example of the right value

## Other responses

- `400` — code | title ------- | ------------------------------------- 425 | INVALID DATE 477 | INVALID FORMAT 2668 | PARAMETER COMBINATION INVALID/RESTRICTED 4926 | INVALID DATA RECEIVED 32171 | MANDATORY DATA MISSING
- `404` — code | title ------- | ------------------------------------- 6003 | ITEM/DATA NOT FOUND OR DATA NOT EXISTING
- `500` — Unexpected error

---

[API](https://skmtc.net/amadeus4dev/apis/flight-inspiration-search.md) · [All operations](https://skmtc.net/amadeus4dev/apis/flight-inspiration-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/amadeus4dev/flight-inspiration-search/versions/09819faaefe3/schema)