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 Reservations Booking API

The Booking API from Amadeus Reservations — 5 operation(s) for booking.

Amadeus Reservations Booking API is published by Amadeus Reservations on the APIs.io network, described by a machine-readable OpenAPI specification.

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

This API exposes 6 operations across 5 paths, and defines 144 schemas. It is described by OpenAPI 3.2.0, at version 1.10.0.

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

6 operations 5 paths 144 schemas 1 DELETE1 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

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

Paths & Operations 6

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

Booking 6
POST
/booking/flight-orders
Amadeus Create Order Associated to the Flight Offers.
createFligtOrders body → 201400default
GET
/booking/flight-orders/{flight-orderId}
Amadeus Retrieve a Given Flight Order
getFlightOrder 1 param → 200400404default
DELETE
/booking/flight-orders/{flight-orderId}
Amadeus Cancel a Given Flight Order
cancelFlightOrder 1 param → 204400404default
POST
/booking/hotel-orders
Amadeus Create Hotel Order
createHotelOrder body → 201400500
POST
/ordering/transfer-orders
Amadeus Performs a Transfer Reservation.
createTransferOrder 1 param body → 201400401default
POST
/ordering/transfer-orders/{orderId}/transfers/cancellation
Amadeus Cancel a Transfer in an Existing OrderId.
cancelTransfer 2 params → 200400401404default

Schemas 144

The contract defines 144 schemas that model the data the API accepts and returns. The most detailed are Transfer (17 properties), FlightOffer (16 properties), FlightOrder (14 properties), HotelProduct (11 properties). Each schema is shown below with its type and property counts.

PaymentInput
object
Model with the hotel payment information
3 properties 1 required
OtherPaymentMethod
string
other payment method
CreditCardBrand
string
credit card brand
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
Error_400_3
object
1 property 1 required
Error_400_2
object
1 property 1 required
OriginalFlightStop
object
details of stops for direct or change of gauge flights
2 properties
ContactWithAddress
Contact and Adress details
CreditCard_2
object
information about payment card
5 properties 4 required
Passenger
passenger data
Warning
object
The Warning Definition
7 properties 2 required
Hotel_Contact
object
Contact Details
3 properties 1 required
TransferReservation
transfer reservation
PhoneDeviceType
string
Type of the device (Landline, Mobile or Fax)
PricingOptionsFareType
array
type of fare of the flight-offer
Distance
object
2 properties
AutomatedProcessCode
string
queuing action to be taken
AutomatedProcessCommon
object
Provides information on ticketing arrangements and Amadeus Time Limits
3 properties
Issue_3
object
5 properties
Error_404
object
1 property 1 required
Stakeholder
object
stakeholder definition
5 properties
Agency
object
Agency email information.
1 property
Errors
object
A set of errors
1 property
TravelSegmentLocation
object
The flight or train departure/arrival date&time, location information
3 properties
ServiceProvider
object
information about provider
8 properties 3 required
ChargeableSeat
object
Details of chargeable seat
2 properties
Baggage
object
2 properties
Error_401
object
1 property 1 required
Fee_2
single fee information
Traveler
the traveler of the trip
TravelClass
string
quality of service offered in the cabin where the seat is located in this flight. Economy, premium economy, business or first class
Equipment
object
extra equipment information
8 properties 1 required
Guest
object
This modele represent a guest, his name, his loyalty programs, his age when it is a child...
7 properties
AssociatedRecord
record associated to the order
LoyaltyNumber
object
2 properties
Co2Emission
object
3 properties
Segment
StakeholderGender
string
Gender for individual
HotelOffer
Hotel Offer
AutomatedProcess
automatic process applied to the Order
Corporation
object
information about corporation
2 properties
ChargeableCheckdBags
Details of chargeable checked bags
PaymentOutput
object
Model with the hotel payment information
5 properties 1 required
Contact_2
object
2 properties
Remarks
object
remarks
2 properties
FeeType
string
type of fee
FormOfPayment
object
form of payment used
3 properties
ServiceName
string
type of service
Price
object
6 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
AirTravelDocumentCommon
object
3 properties
AllotmentDetails
object
2 properties
VirtualCreditCardDetails
detail information of the virtual card
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
Error_400
object
1 property 1 required
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
HotelProduct_PaymentPolicy
object
Accepted Payment Methods and Card Types. Several Payment Methods and Card Types may be available.
2 properties
HotelBooking
object
An hotel booking represent one or several rooms booked in the same physical hotel. There is always a reference to this booking, provided by the hotel provider,…
10 properties 7 required
Phone
object
phone information
3 properties
FlightOffer
object
16 properties 2 required
Tax
object
a tax
2 properties
Error_500_2
object
1 property 1 required
AirlineRemark
object
6 properties 3 required
TransferCancellation
object
information returned in cancelation response
2 properties
Collection_Meta_Link
object
2 properties
DocumentType
string
the nature/type of the document
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
CreditCard
object
credit card
AddressCommon
object
address of the departure location
5 properties
Transfer
object
17 properties 6 required
Issue
object
5 properties
GeneralRemark
object
5 properties 2 required
guests
object
2 properties
Issue_2
object
5 properties
LocationValue
object
2 properties
Extended_Price
object
price information
OtherMethod
object
other payment method
2 properties
DiscountType
string
type of discount applied
DiscountTravelerType
string
type of discount applied
Vehicle
object
6 properties 4 required
Document
object
the information that are found on an ID document
7 properties
IdentityDocument
documents of the traveler
Name
name
HotelOrder
object
An Hotel Order is one or several hotel bookings done for a set of guest.
6 properties 6 required
TransportationType
string
The type of connection "FLIGHT" or "TRAIN"
Seat
object
3 properties
Payment
object
defines the payment in transfer reservation. For "CREDITCARD" - creditCard is mandatory, for "TRAVELACCOUNT" - paymentReference is optional, for "PAYMENTSERVIC…
4 properties
Price_2
object
Price valuation information
5 properties
AssociatedRecordCommon
object
describes the relation between the current reservation and another one
3 properties
DiscountCode
object
discount object that gives access to negotiated prices
2 properties
FlightStop
details of stops for direct or change of gauge flights
ExtraService
object
10 properties 1 required
ArrivalFlightDetails
object
4 properties 3 required
HotelProduct_DepositPolicy
object
the deposit/prepay policy information applicable to the offer. It includes accepted payments, deadline and the amount due
4 properties
CarrierEntry
Discount
object
traveler discount
5 properties
AircraftEntry
LoyaltyProgram
object
loyalty program information
2 properties
OriginalFlightEndPoint
object
departure or arrival information
2 properties
Address_3
object
Address information
5 properties 3 required
LocationEntry
Address_4
object
address information
7 properties
ElementaryPrice
object
elementaryPrice
2 properties
AircraftEquipment
object
information related to the aircraft
1 property
PointsAndCash
object
1 property
SliceDiceIndicator
string
slice and Dice indicator, such as Local Availability, Sub OnD(Origin and Destination) 1 Availability and Sub OnD 2 Availability
EmergencyContact
object
emergency contact number
4 properties
B2bWallet
object
b2b wallet
6 properties
HotelProduct
object
Hotel Offer
11 properties 3 required
Error_500
object
1 property 1 required
ContactPurpose
string
the purpose for which this contact is to be used. - STANDARD for standard use, comunication, advertissement etc... - INVOICE for your invoice contact, usually…
OperatingFlight
object
information about the operating flight
1 property
TransferOrder
object
6 properties 3 required
FlightSegment
object
defining a flight segment; including both operating and marketing details when applicable
8 properties
Error_500_3
object
1 property 1 required
TravelerType
string
traveler type age restrictions : CHILD =60y
AirTravelDocument
ticket information
FlightEndPoint
departure or arrival information
Name_2
object
description of the name of a physical person
4 properties
Location
object
location information
6 properties
CreditCardCommon
object
credit card common attribute
4 properties
FormOfIdentification
object
alternative means of identifying stakeholders for eTicket.
5 properties
Fee
object
a fee
2 properties
CancellationRule
object
cancellation rule information
7 properties
Dictionaries
object
4 properties
TicketingAgreement
object
ticketing agreement
4 properties
BaggageAllowance
object
baggageAllowance
3 properties
Tax_2
single tax information
AirlineRemarkType
string
airline remark type
ContactDictionary
object
represents a contact
4 properties
PassengerCharacteristics
object
2 properties
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
Guests
array
Array of guests sharing the hotelOrder.
Contact
contact information
TicketingAgreementOption
string
Ticketing agreement option CONFIRM, when the payment is done DELAYTOQUEUE, queue the reservation at a wished date if the payment is not done DELAYTOCANCEL, can…
GeneralRemarkType
string
general remark type
AdditionalServiceType
string
additional service type
CreateHotelBooking
object
This model allows the creation of an hotel order.
4 properties 1 required
roomAssociation
object
Room Association represents a room booked in an hotel, the guests sleeping in this room, the hotel loyalty program if any, plus special request if any.
3 properties 2 required
BaseName
object
description of the name of a physical person
3 properties
CurrencyEntry
Address
object
address information
6 properties
FlightOrder
object
input parameter to create a flight order
14 properties 2 required
FlightOfferSource
string
source of the flight offer

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

amadeus-reservations-booking-api-openapi.yml Raw ↑
Where this information came from

This is an independent, third-party profile of Amadeus Reservations Booking 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.