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
# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/openapi/amadeus-flight-inspiration-search-openapi.yml