swagger: '2.0' info: version: 1.0.6 title: Amadeus Flight Inspiration Search x-tags: - '#ama-for-dev' x-status: validated x-release-note: 1.0.0: - Initial Version 1.0.1: - Clarified example for the parameters origin and currency - Added links to ISO, IATA kind of references 1.0.2: - Correct example 1.0.3: - Hide currency parameter 1.0.4: - Update example - Change link of FlightOffer from v1 to v2 description: "\nBefore using this API, we recommend you read our **[Authorization Guide](https://developers.amadeus.com/self-service/apis-docs/guides/authorization-262)** for more information on how to generate an access token.\n\nPlease also be aware that our test environment is based on a subset of the production, to see what is included in test please refer to our **[data collection](https://github.com/amadeus4dev/data-collection)**.\n" host: test.api.amadeus.com basePath: /v1 schemes: - https consumes: - application/vnd.amadeus+json - application/json produces: - application/vnd.amadeus+json - application/json paths: /shopping/flight-destinations: get: tags: - Shopping operationId: getFlightDestinations summary: Amadeus Find the Cheapest Destinations Where You Can Fly To. parameters: - name: origin in: query description: > 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 required: true type: string pattern: '[A-Z]{3}' x-example: MAD - name: departureDate in: query description: > 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. required: false type: string - name: oneWay in: query description: >- 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 required: false type: boolean default: false - name: duration in: query description: | 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 required: false type: string minimum: 1 maximum: 15 - name: nonStop in: query description: >- if this parameter is set to true, only flights going from the origin to the destination with no stop in-between are considered required: false type: boolean default: false - name: maxPrice in: query description: >- defines the price limit for each offer returned. The value should be a positive number, without decimals required: false type: integer format: int64 minimum: 0 - name: viewBy in: query description: >- 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 required: false type: string enum: - COUNTRY - DATE - DESTINATION - DURATION - WEEK responses: '200': $ref: '#/responses/200' '400': $ref: '#/responses/400' '404': $ref: '#/responses/404' '500': $ref: '#/responses/500' description: '' definitions: Links: properties: self: type: string format: uri Price: properties: total: description: Total amount paid by the user type: string example: '932.70' LocationDictionary: additionalProperties: $ref: '#/definitions/LocationValue' LocationValue: properties: subType: type: string description: 'location type: airport or city' enum: - AIRPORT - CITY example: AIRPORT detailedName: type: string description: name of the location example: 'Paris/FR: Charles de Gaulle' CurrencyDictionary: additionalProperties: type: string example: EUR FlightDestinations: type: object properties: data: type: array items: $ref: '#/definitions/FlightDestination' dictionaries: $ref: '#/definitions/Dictionaries' meta: $ref: '#/definitions/Meta' warnings: type: array items: $ref: '#/definitions/Issue' example: - status: '200' code: '12345' title: WARNING example: data: - type: flight-destination origin: MAD destination: ALC departureDate: '2020-10-23' returnDate: '2020-10-26' price: total: '52.52' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=ALC&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=ALC&departureDate=2020-10-23&returnDate=2020-10-26&adults=1&nonStop=false - type: flight-destination origin: MAD destination: LON departureDate: '2020-10-22' returnDate: '2020-10-25' price: total: '71.15' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=LON&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=LON&departureDate=2020-10-22&returnDate=2020-10-25&adults=1&nonStop=false - type: flight-destination origin: MAD destination: MUC departureDate: '2020-08-12' returnDate: '2020-08-17' price: total: '98.53' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=MUC&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=MUC&departureDate=2020-08-12&returnDate=2020-08-17&adults=1&nonStop=false - type: flight-destination origin: MAD destination: WAW departureDate: '2020-07-30' returnDate: '2020-08-06' price: total: '108.30' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=WAW&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=WAW&departureDate=2020-07-30&returnDate=2020-08-06&adults=1&nonStop=false - type: flight-destination origin: MAD destination: KRK departureDate: '2020-07-25' returnDate: '2020-08-01' price: total: '116.81' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=KRK&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=KRK&departureDate=2020-07-25&returnDate=2020-08-01&adults=1&nonStop=false - type: flight-destination origin: MAD destination: GOA departureDate: '2020-09-07' returnDate: '2020-09-11' price: total: '123.78' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=GOA&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=GOA&departureDate=2020-09-07&returnDate=2020-09-11&adults=1&nonStop=false - type: flight-destination origin: MAD destination: VIE departureDate: '2020-07-31' returnDate: '2020-08-05' price: total: '124.27' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=VIE&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=VIE&departureDate=2020-07-31&returnDate=2020-08-05&adults=1&nonStop=false - type: flight-destination origin: MAD destination: VCE departureDate: '2020-10-25' returnDate: '2020-10-26' price: total: '127.96' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=VCE&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=VCE&departureDate=2020-10-25&returnDate=2020-10-26&adults=1&nonStop=false - type: flight-destination origin: MAD destination: GOT departureDate: '2020-08-02' returnDate: '2020-08-16' price: total: '147.78' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=GOT&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=GOT&departureDate=2020-08-02&returnDate=2020-08-16&adults=1&nonStop=false - type: flight-destination origin: MAD destination: LWO departureDate: '2020-07-30' returnDate: '2020-08-04' price: total: '158.29' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=LWO&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=LWO&departureDate=2020-07-30&returnDate=2020-08-04&adults=1&nonStop=false - type: flight-destination origin: MAD destination: GLA departureDate: '2020-09-01' returnDate: '2020-09-04' price: total: '162.72' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=GLA&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=GLA&departureDate=2020-09-01&returnDate=2020-09-04&adults=1&nonStop=false - type: flight-destination origin: MAD destination: CLJ departureDate: '2020-10-14' returnDate: '2020-10-22' price: total: '163.16' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=CLJ&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=CLJ&departureDate=2020-10-14&returnDate=2020-10-22&adults=1&nonStop=false - type: flight-destination origin: MAD destination: RIX departureDate: '2020-08-03' returnDate: '2020-08-10' price: total: '167.72' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=RIX&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=RIX&departureDate=2020-08-03&returnDate=2020-08-10&adults=1&nonStop=false - type: flight-destination origin: MAD destination: TLL departureDate: '2020-08-05' returnDate: '2020-08-11' price: total: '167.75' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=TLL&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=TLL&departureDate=2020-08-05&returnDate=2020-08-11&adults=1&nonStop=false - type: flight-destination origin: MAD destination: MOW departureDate: '2020-07-28' returnDate: '2020-08-03' price: total: '176.63' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=MOW&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=MOW&departureDate=2020-07-28&returnDate=2020-08-03&adults=1&nonStop=false - type: flight-destination origin: MAD destination: KIV departureDate: '2020-11-01' returnDate: '2020-11-16' price: total: '220.51' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=KIV&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=KIV&departureDate=2020-11-01&returnDate=2020-11-16&adults=1&nonStop=false - type: flight-destination origin: MAD destination: BOS departureDate: '2020-07-30' returnDate: '2020-08-14' price: total: '289.78' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=BOS&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=BOS&departureDate=2020-07-30&returnDate=2020-08-14&adults=1&nonStop=false - type: flight-destination origin: MAD destination: MTY departureDate: '2020-10-18' returnDate: '2020-10-19' price: total: '326.09' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=MTY&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=MTY&departureDate=2020-10-18&returnDate=2020-10-19&adults=1&nonStop=false - type: flight-destination origin: MAD destination: FLL departureDate: '2020-10-31' returnDate: '2020-11-01' price: total: '359.01' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=FLL&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=FLL&departureDate=2020-10-31&returnDate=2020-11-01&adults=1&nonStop=false - type: flight-destination origin: MAD destination: DEN departureDate: '2020-10-18' returnDate: '2020-10-19' price: total: '386.82' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=DEN&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=DEN&departureDate=2020-10-18&returnDate=2020-10-19&adults=1&nonStop=false - type: flight-destination origin: MAD destination: ACC departureDate: '2020-10-17' returnDate: '2020-10-27' price: total: '428.52' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=ACC&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=ACC&departureDate=2020-10-17&returnDate=2020-10-27&adults=1&nonStop=false - type: flight-destination origin: MAD destination: ORL departureDate: '2020-09-05' returnDate: '2020-09-06' price: total: '433.09' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=ORL&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=ORL&departureDate=2020-09-05&returnDate=2020-09-06&adults=1&nonStop=false - type: flight-destination origin: MAD destination: TYO departureDate: '2020-08-04' returnDate: '2020-08-10' price: total: '456.05' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=TYO&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=TYO&departureDate=2020-08-04&returnDate=2020-08-10&adults=1&nonStop=false - type: flight-destination origin: MAD destination: SSA departureDate: '2020-08-02' returnDate: '2020-08-03' price: total: '459.73' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=SSA&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=SSA&departureDate=2020-08-02&returnDate=2020-08-03&adults=1&nonStop=false - type: flight-destination origin: MAD destination: MGA departureDate: '2020-10-20' returnDate: '2020-10-27' price: total: '484.84' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=MGA&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=MGA&departureDate=2020-10-20&returnDate=2020-10-27&adults=1&nonStop=false - type: flight-destination origin: MAD destination: SIN departureDate: '2020-11-06' returnDate: '2020-11-10' price: total: '521.21' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=SIN&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=SIN&departureDate=2020-11-06&returnDate=2020-11-10&adults=1&nonStop=false - type: flight-destination origin: MAD destination: CCS departureDate: '2020-09-08' returnDate: '2020-09-15' price: total: '528.17' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=CCS&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=CCS&departureDate=2020-09-08&returnDate=2020-09-15&adults=1&nonStop=false - type: flight-destination origin: MAD destination: SLC departureDate: '2020-10-16' returnDate: '2020-10-17' price: total: '550.01' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=SLC&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=SLC&departureDate=2020-10-16&returnDate=2020-10-17&adults=1&nonStop=false - type: flight-destination origin: MAD destination: SEA departureDate: '2020-10-31' returnDate: '2020-11-01' price: total: '590.64' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=SEA&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=SEA&departureDate=2020-10-31&returnDate=2020-11-01&adults=1&nonStop=false - type: flight-destination origin: MAD destination: RGN departureDate: '2020-08-27' returnDate: '2020-08-30' price: total: '628.70' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=RGN&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=RGN&departureDate=2020-08-27&returnDate=2020-08-30&adults=1&nonStop=false - type: flight-destination origin: MAD destination: KTM departureDate: '2020-07-24' returnDate: '2020-07-27' price: total: '629.07' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=KTM&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=KTM&departureDate=2020-07-24&returnDate=2020-07-27&adults=1&nonStop=false - type: flight-destination origin: MAD destination: MDZ departureDate: '2020-07-24' returnDate: '2020-07-31' price: total: '670.41' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=MDZ&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=MDZ&departureDate=2020-07-24&returnDate=2020-07-31&adults=1&nonStop=false - type: flight-destination origin: MAD destination: HNL departureDate: '2020-09-13' returnDate: '2020-09-18' price: total: '1176.87' links: flightDates: >- https://test.api.amadeus.com/v1/shopping/flight-dates?origin=MAD&destination=HNL&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DURATION flightOffers: >- https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=MAD&destinationLocationCode=HNL&departureDate=2020-09-13&returnDate=2020-09-18&adults=1&nonStop=false dictionaries: currencies: EUR: EURO locations: CLJ: subType: AIRPORT detailedName: CLUJ NAPOCA RIX: subType: AIRPORT detailedName: RIGA INTL KTM: subType: AIRPORT detailedName: TRIBHUVAN INTL KRK: subType: AIRPORT detailedName: JOHN PAUL II BALICE HNL: subType: AIRPORT detailedName: DANIEL K INOUYE INTL FLL: subType: AIRPORT detailedName: FLL INTL ORL: subType: AIRPORT detailedName: EXECUTIVE SLC: subType: AIRPORT detailedName: SALT LAKE CITY INTL WAW: subType: AIRPORT detailedName: FREDERIC CHOPIN MTY: subType: AIRPORT detailedName: MARIANO ESCOBEDO INTL TLL: subType: AIRPORT detailedName: LENNART MERI GOA: subType: AIRPORT detailedName: CRISTOFORO COLOMBO MUC: subType: AIRPORT detailedName: MUNICH INTERNATIONAL SSA: subType: AIRPORT detailedName: D.L.E.MAGALHAES ACC: subType: AIRPORT detailedName: KOTOKA INTL MDZ: subType: AIRPORT detailedName: EL PLUMERILLO LWO: subType: AIRPORT detailedName: INTERNATIONAL MGA: subType: AIRPORT detailedName: AUGUSTO C.SANDINO INT BOS: subType: AIRPORT detailedName: EDWARD L LOGAN INTL LON: subType: CITY detailedName: LONDON TYO: subType: CITY detailedName: TOKYO DEN: subType: AIRPORT detailedName: DENVER INTERNATIONAL GOT: subType: AIRPORT detailedName: LANDVETTER SEA: subType: AIRPORT detailedName: SEATTLE TACOMA INTL MAD: subType: AIRPORT detailedName: ADOLFO SUAREZ BARAJAS CCS: subType: AIRPORT detailedName: SIMON BOLIVAR INTL VIE: subType: AIRPORT detailedName: VIENNA INTERNATIONAL MOW: subType: CITY detailedName: MOSCOW RGN: subType: AIRPORT detailedName: MINGALADON ALC: subType: AIRPORT detailedName: ALICANTE AIRPORT KIV: subType: AIRPORT detailedName: INTERNATIONAL VCE: subType: AIRPORT detailedName: MARCO POLO SIN: subType: AIRPORT detailedName: CHANGI GLA: subType: AIRPORT detailedName: GLASGOW INTL meta: currency: EUR links: self: >- https://test.api.amadeus.com/v1/shopping/flight-destinations?origin=MAD&departureDate=2020-07-24,2021-01-19&oneWay=false&duration=1,15&nonStop=false&viewBy=DESTINATION defaults: departureDate: 2020-07-24,2021-01-19 oneWay: false duration: 1,15 nonStop: false viewBy: DESTINATION FlightDestination: type: object properties: type: type: string description: the resource name example: flight-destination origin: type: string example: PAR destination: type: string example: DXB departureDate: type: string example: '2017-08-19' returnDate: type: string example: '2017-08-22' price: $ref: '#/definitions/Price' links: type: object properties: flightDates: type: string example: https://test.api.amadeus.com/v1/shopping/flight-dates?origin=PAR flightOffers: type: string example: >- https://test.api.amadeus.com/v1/shopping/flight-offers?origin=PAR&destination=MAD&departureDate=2017-08-26&returnDate=2017-08-30&adults=1 Dictionaries: type: object properties: currencies: $ref: '#/definitions/CurrencyDictionary' locations: $ref: '#/definitions/LocationDictionary' Meta: type: object properties: currency: type: string description: >- 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 pattern: '[A-Z]{3}' example: EUR links: $ref: '#/definitions/Links' defaults: $ref: '#/definitions/Defaults' Defaults: description: the query parameters for which default values were used are returned here type: object properties: departureDate: description: >- 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 type: string example: 2011-09-10,2011-09-15 oneWay: description: >- 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 type: boolean example: true duration: description: >- 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 type: string example: 2,5 nonStop: description: >- if this parameter is set to true, only flights going from the origin to the destination with no stop in-between are considered type: boolean example: true viewBy: type: string description: >- 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 enum: - COUNTRY - DATE - DESTINATION - DURATION - WEEK Error_400: properties: errors: type: array items: $ref: '#/definitions/Issue' required: - errors example: errors: - status: 400 code: 477 title: INVALID FORMAT detail: invalid query parameter format source: parameter: airport example: CDG Error_404: properties: errors: type: array items: $ref: '#/definitions/Issue' required: - errors example: errors: - status: 404 code: 1797 title: NOT FOUND detail: no response found for this query parameter source: parameter: airport Error_500: properties: errors: type: array items: $ref: '#/definitions/Issue' required: - errors example: errors: - status: 500 code: 141 title: SYSTEM ERROR HAS OCCURRED Issue: properties: status: description: the HTTP status code applicable to this error type: integer code: description: an application-specific error code type: integer format: int64 title: description: a short summary of the error type: string detail: description: explanation of the error type: string source: type: object title: Issue_Source description: an object containing references to the source of the error maxProperties: 1 properties: pointer: description: >- a JSON Pointer [RFC6901] to the associated entity in the request document type: string parameter: description: a string indicating which URI query parameter caused the issue type: string example: description: a string indicating an example of the right value type: string responses: '200': description: Success schema: $ref: '#/definitions/FlightDestinations' '400': description: | code | title - | - 425 | INVALID DATE 477 | INVALID FORMAT 2668 | PARAMETER COMBINATION INVALID/RESTRICTED 4926 | INVALID DATA RECEIVED 32171 | MANDATORY DATA MISSING schema: $ref: '#/definitions/Error_400' '404': description: | code | title - | - 6003 | ITEM/DATA NOT FOUND OR DATA NOT EXISTING schema: $ref: '#/definitions/Error_404' '500': description: Unexpected error schema: $ref: '#/definitions/Error_500' x-generatedAt: '2020-07-23T08:15:14.050Z' tags: - name: Shopping