swagger: '2.0' info: version: 1.0.6 title: 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: - flight-destinations 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 x-example: '2026-08-15' - 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 x-example: true - 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 x-example: PT2H30M - 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 x-example: true - 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 x-example: '199.50' - 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 x-example: COUNTRY responses: '200': $ref: '#/responses/200' '400': $ref: '#/responses/400' '404': $ref: '#/responses/404' '500': $ref: '#/responses/500' description: '' x-microcks-operation: delay: 0 dispatcher: FALLBACK definitions: Links: properties: self: type: string format: uri example: https://example.com/resource 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 example: COUNTRY 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 example: 1 code: description: an application-specific error code type: integer format: int64 example: 1 title: description: a short summary of the error type: string example: string-value detail: description: explanation of the error type: string example: string-value 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 example: string-value parameter: description: a string indicating which URI query parameter caused the issue type: string example: string-value example: description: a string indicating an example of the right value type: string example: string-value 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'