How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Amadeus Shopping API

The Shopping API from Amadeus — 6 operation(s) for shopping.

Amadeus Shopping API is one of 26 APIs that Amadeus publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1594 JSON Schema definitions.

Tagged areas include Shopping. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 1594 JSON Schemas.

This API exposes 7 operations across 6 paths, and defines 149 schemas. It is described by OpenAPI 3.2.0, at version 1.2.1.

Requests are made against a single base URL, https://test.api.amadeus.com/v1.

7 operations 6 paths 149 schemas 3 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.2.1
Base URL
https://test.api.amadeus.com/v2
Resource Areas
1

Paths & Operations 7

Across 6 paths, the API surfaces 7 operations — 3 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Shopping 7
POST
/shopping/flight-offers/upselling
Amadeus Return a List of Upsell Flight Offers Based on Given Flight Offers
upsellAirOffers 2 params → 200400default
POST
/shopping/flight-offers/pricing
Amadeus Confirm Pricing of Given FlightOffers.
quoteAirOffers 4 params → 200400default
POST
/shopping/flight-offers
Amadeus Return List of Flight Offers Based on Posted Searching Criteria.
searchFlightOffers 2 params → 200400default
GET
/shopping/flight-offers
Amadeus Return List of Flight Offers Based on Searching Criteria.
getFlightOffers 14 params → 200400default
GET
/shopping/hotel-offers
Amadeus GetMultiHotelOffers
getMultiHotelOffers 13 params → 200400500
GET
/shopping/hotel-offers/{offerId}
Amadeus GetOfferPricing
getOfferPricing 2 params → 200400404500
POST
/shopping/transfer-offers
Amadeus Gets Transfer Offers.
getTransferOffers 1 param → 200400401default

Schemas 149

The contract defines 149 schemas that model the data the API accepts and returns. The most detailed are FlightOffer (16 properties), HotelOffer (16 properties), StopOverRequest (12 properties), ExtraService (10 properties). Each schema is shown below with its type and property counts.

ServiceName
string
type of service
HotelProduct_EstimatedRoomType
object
estimated room category, bed type and number of beds in the room. This information has been parsed from the room description, and is thus only provided for inf…
3 properties
AllotmentDetails
object
2 properties
TravelSegmentLocation
object
The flight or train departure/arrival date&time, location information
3 properties
Stakeholder
object
stakeholder definition
5 properties
DateTimeType
object
2 properties 1 required
TravelerType
string
traveler type age restrictions : CHILD =60y
MultiResponse
object
1 property
SearchCriteria
object
9 properties
LoyaltyProgram
object
loyalty program information
2 properties
FlightOfferSource
string
source of the flight offer
Address_2
object
address information
7 properties
Hotel
object
Hotel Content
6 properties
Contact
contact information
BaseName
object
description of the name of a physical person
3 properties
AircraftEquipment
object
information related to the aircraft
1 property
FlightFilters
object
9 properties
HotelOffer
object
Hotel Offer
16 properties 4 required
BoardType
string
The included Breakfast/Meals
PhoneDeviceType
string
Type of the device (Landline, Mobile or Fax)
Phone
object
phone information
3 properties
FlightStop
details of stops for direct or change of gauge flights
StakeholderGender
string
The gender
Vehicle
object
6 properties 4 required
DiscountCode
object
discount object that gives access to negotiated prices
2 properties
Dictionaries
object
4 properties
Error_400_2
object
1 property 1 required
IdentityDocument
documents of the traveler
Price_2
object
Price valuation information
5 properties
OriginDestination
Method
string
The Payment Methods CREDITCARD (CC) - Payment Cards in creditCards are accepted AGENCYACCOUNT - Agency Account (Credit Line) is accepted. Agency is Charged at…
Contact_2
object
2 properties
Payment
object
3 properties
ContactWithAddress
Contact and Adress details
LocationValue
object
2 properties
StopOver
object
Location of the stop over or the several stop over points. It can be defined either using IATA code or Address (address line, zip, country, city, state, latitu…
3 properties
Error_400_3
object
1 property 1 required
HotelProduct_PolicyDetails
object
Booking Rules
7 properties
ContactDictionary
object
represents a contact
4 properties
Issue
object
5 properties
FlightOfferUpsellIn
object
input parameter to upsell flight offers element
3 properties 2 required
FlightSegment
object
defining a flight segment; including both operating and marketing details when applicable
8 properties
Fee
object
a fee
2 properties
ContactPurpose
string
the purpose for which this contact is to be used
Address
object
address information
6 properties
DetailedFareRules
object
4 properties
StopOverRequest
object
12 properties
Equipment
object
extra equipment information
8 properties 1 required
FlightOffer
object
16 properties 2 required
CabinRestriction
object
2 properties
HotelProduct_PriceVariations
object
Daily price variations and the average daily price (when available) is shown here
2 properties
ExtraService
object
10 properties 1 required
Extended_Price
object
price information
ElementaryPrice
object
elementaryPrice
2 properties
TravelerInfo
object
3 properties 2 required
Markup
object
Markup applied to provide a service or a product to the client. The markup can be introduced by any stakeholder. Typical use case is to convey markup informati…
1 property
DiscountTravelerType
string
type of discount applied
Co2Emission
object
3 properties
PassengerCharacteristics
object
2 properties
Seat
object
3 properties
Error_500
object
1 property 1 required
TravelSegment
object
A segment of an itinerary used by a traveler between 2 locations at a given date and time using a particular transportation type FLIGHT or TRAIN
4 properties
PricingOptionsFareType
array
type of fare of the flight-offer
EmergencyContact
object
emergency contact number
4 properties
Bags
checked bag
PartnerInfo
object
Information about partner/subprovider. Below settings configuration is not applicable for sub-provider. Fields 'code', 'name' and 'logoUrl' are not mandatory f…
1 property
HotelProduct_Guests
object
2 properties
QualifiedFreeText
object
Specific type to convey a list of string for specific information type ( via qualifier) in specific character set, or language
2 properties
Price
object
6 properties
Document
object
the information that are found on an ID document
7 properties
OtherServices
object
6 properties
Errors
object
A set of errors
1 property
CarrierEntry
Error
object
The Error Definition
6 properties
PricingResponse
object
1 property
HotelProduct_CancellationPolicy
object
6 properties
PointsAndCash
object
1 property
AdditionalServiceType
string
additional service type
Issue_3
object
5 properties
Tax_3
single tax information
Quotation
quotation representing a price valuation and its components. The monetaryAmount at the root are the sum of base and all the taxes/fees/discounts
DiscountType
string
type of discount applied
CancellationType
string
FULLSTAY: the Penalty amount equals the total price.
Collection_Meta
object
2 properties
HotelProduct_Commission
object
3 properties
HotelProduct_CheckInOutPolicy
object
4 properties
ChargeableSeat
object
Details of chargeable seat
2 properties
Location
object
location information
6 properties
DocumentType
string
the nature/type of the document
HotelProduct_HotelPrice
object
price information
7 properties
CancellationRule
object
cancellation rule information
7 properties
Segment
Tax
object
a tax
2 properties
Error_400
object
1 property 1 required
Extended_TravelerInfo
2 required
OperatingFlight
object
information about the operating flight
1 property
ServiceProvider
object
information about provider
8 properties 3 required
FlightEndPoint
departure or arrival information
Extended_CabinRestriction
OriginalFlightEndPoint
object
departure or arrival information
2 properties
PaymentBrand
string
credit card brand
OriginalFlightStop
object
details of stops for direct or change of gauge flights
2 properties
TransferOffer
transfer offer
AddressCommon
object
address of the departure location
5 properties
TravelerPricingFareOption
string
option specifying a group of fares, which may be valid under certain conditons Can be used to specify special fare discount for a passenger
TransferOfferPost
transfer offer
Collection_Meta_Link
object
2 properties
Issue_2
object
5 properties
OriginDestinationLight
object
5 properties
Error_Source
object
3 properties
Discount
object
traveler discount
5 properties
HotelProduct_HoldPolicy
object
the hold policy
1 property 1 required
SliceDiceIndicator
string
slice and Dice indicator, such as Local Availability, Sub OnD(Origin and Destination) 1 Availability and Sub OnD 2 Availability
Baggage
object
2 properties
FlightOfferPricingIn
object
input parameter to price flight offers element
4 properties 2 required
Name
name
GetFlightOffersQuery
object
5 properties 3 required
Coverage
string
part of the trip covered by the travel class restriction (ALLSEGMENTS if ommited)
Error_500_3
object
1 property 1 required
Error_401
object
1 property 1 required
HotelProduct_PaymentPolicy
object
Accepted Payment Methods and Card Types. Several Payment Methods and Card Types may be available.
2 properties
Collection_Meta_Upsell
object
2 properties
LocationEntry
FeeType
string
type of fee
Traveler
the traveler of the trip
HotelProduct_DepositPolicy
object
the deposit/prepay policy information applicable to the offer. It includes accepted payments, deadline and the amount due
4 properties
FlightOfferPricingOut
object
priced flight Offers and conditions
3 properties 2 required
Type
string
data type
Extended_PricingOptions
object
fare filter options
4 properties
BaggageAllowance
object
baggageAllowance
3 properties
TravelClass
string
quality of service offered in the cabin where the seat is located in this flight. Economy, premium economy, business or first class
CurrencyEntry
ConnectionRestriction
object
Restriction towards number of connections.
4 properties
ChargeableCheckdBags
Details of chargeable checked bags
TransportationType
string
The type of connection "FLIGHT" or "TRAIN"
Distance
object
2 properties
CarrierRestrictions
object
Restriction towards carriers.
3 properties
TermAndCondition
object
5 properties
DateTimeRange
1 required
HotelOffers
object
5 properties
Tax_2
object
IATA Tax definition: An impost for raising revenue for the general treasury and which will be used for general public purposes.
8 properties
CreditCardFee
object
4 properties
PaymentType
string
payment type. Guarantee means Pay at Check Out. Check the methods in guarantee or deposit or prepay.
HotelProduct_GuaranteePolicy
object
the guarantee policy information applicable to the offer. It includes accepted payments
2 properties
AircraftEntry
HotelProduct_RateFamily
object
The estimated rate code family of the offer. Grouping various rate plan codes that belongs to the same family and indicates the type of the rate
2 properties
HotelProduct_PriceVariation
object
Some prices may vary during a stay, thus here you can see the daily price per period of the stay
7 properties 2 required
HotelProduct_RoomDetails
object
3 properties
Fee_2
single fee information

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

amadeus-shopping-api-openapi.yml Raw ↑

Other APIs Amadeus publishes across the network.

Amadeus air-traffic API
Amadeus airlines API
Amadeus airport-ontime-prediction API
Amadeus Availibility API
Amadeus Booking API
Amadeus category-rated-areas API
Amadeus checkin-links API
Amadeus City API
Amadeus destinations API
Amadeus direct-destinations API
Amadeus Display SeatMaps API
Amadeus flight-choice-prediction API
Where this information came from

This is an independent, third-party profile of Amadeus Shopping API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.