Amadeus MCP Server
by privilegemendes
Verified
- amadeus-mcp-server-standalone
- api-spectifications
{
"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": "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\n\n[IATA table codes](http://www.iata.org/publications/Pages/code-search.aspx) - e.g. MAD for Madrid\n",
"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. \n\nRanges are specified with a comma and are inclusive\n\nDeparture date can not be more than 180 days in the future.\n",
"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.\n\nThis parameter must not be set if oneWay is true. \n\nRanges are specified with a comma and are inclusive, e.g. 2,8\n\nDuration can not be lower than 1 days or higher than 15 days\n",
"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 \n------- | ------------------------------------- \n425 | INVALID DATE\n477 | INVALID FORMAT\n2668 | PARAMETER COMBINATION INVALID/RESTRICTED\n4926 | INVALID DATA RECEIVED\n32171 | MANDATORY DATA MISSING\n",
"schema": {
"$ref": "#/definitions/Error_400"
}
},
"404": {
"description": "code | title \n------- | ------------------------------------- \n6003 | ITEM/DATA NOT FOUND OR DATA NOT EXISTING\n",
"schema": {
"$ref": "#/definitions/Error_404"
}
},
"500": {
"description": "Unexpected error",
"schema": {
"$ref": "#/definitions/Error_500"
}
}
},
"x-generatedAt": "2020-07-23T08:15:14.050Z"
}