Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Expedia Group Manage Booking API

Retrieve existing itineraries or cancel existing rooms.

Expedia Group Manage Booking API is one of 15 APIs that Expedia Group publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

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

This API exposes 6 operations across 4 paths, and defines 58 schemas. It is described by OpenAPI 3.0.1, at version 1.0.

Requests are made against a single base URL, https://services.expediapartnercentral.com/.

6 operations 4 paths 58 schemas 2 DELETE2 GET2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0
Server
https://services.expediapartnercentral.com/
Authentication
HTTP Basic
Resource Areas
1

Authentication & Security 1

Expedia Group Manage Booking API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (Basic). By default, every request must be authenticated.

Paths & Operations 6

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

Manage Booking 6

Retrieve existing itineraries or cancel existing rooms.

GET
/itineraries
Expedia Group Search for and retrieve Bookings with Affiliate Reference Id
getReservation 9 params → 200400401403426429500503
GET
/itineraries/{itinerary_id}
Expedia Group Retrieve Booking
getReservationByItineraryId 10 params → 200400401403404426429500
DELETE
/itineraries/{itinerary_id}
Expedia Group Cancel Held Booking
deleteHeldBooking 8 params → 202204400401403404426429
PUT
/itineraries/{itinerary_id}/rooms/{room_id}
Expedia Group Change details of a room.
changeRoomDetails 10 params body → 202204400401403404426429
DELETE
/itineraries/{itinerary_id}/rooms/{room_id}
Expedia Group Cancel a room.
deleteRoom 9 params → 202204400401403404426429
PUT
/itineraries/{itinerary_id}/rooms/{room_id}/pricing
Expedia Group Commit a change of itinerary that may require additional payment or refund.
commitChange 11 params body → 202204400401403404409410

Schemas 58

The contract defines 58 schemas that model the data the API accepts and returns. The most detailed are RoomHistoryItem (23 properties), Itinerary (17 properties), RoomItinerary (16 properties), RateItinerary (12 properties). Each schema is shown below with its type and property counts.

ItineraryHistoryItem
object
An itinerary history change event, representing a charge or refund made to the itinerary and not a specific room.
5 properties
DepositItinerary
object
The deposit policy associated with the itinerary.
3 properties
Link
object
An individual link.
3 properties
TraderDetails
array
An array of traders.
MerchantOfRecord
string
expedia - Payment is taken by Expedia. property - Payment is taken by the property.
FeesPricingInformation
object
The fees collected by the property. The values for each type of fee are the total for that type. Mandatory fees are collected by the property at check-in or ch…
3 properties
ItineraryLinks
object
A map of links, including links to resume or cancel a held booking. This is only included for held bookings.
2 properties
TraderTermsAndConditions
string
The url linking to the full text terms and conditions.
TraderAddress
object
The trader address.
7 properties
BillingContact
object
3 properties
ErrorIndividual
object
An individual error.
3 properties
TraderName
string
The trader name.
ConfirmationId
object
The confirmation ids.
2 properties
RoomItinerary
object
The room information.
16 properties
Amount
object
The monetary amount.
2 properties
Error
object
The overall class of error that occured.
4 properties
OfferType
string
The type of offer this value add promotion is.
NightChargeType
string
The price breakout type. baserate - The room rate without any taxes and fees applied. taxandservicefee - Tax recovery charges, service fees, and taxes. Ensure…
TraderInformation
object
The professional entity or entities that sells the property inventory or related services.
2 properties 1 required
Loyalty
object
A loyalty object for a loyalty program.
2 properties
Totals
object
The total price of charges, given various criteria. inclusive - provides the total price including taxes and fees. This does not include property collected fee…
10 properties
SupplyContact
object
The supply contact information. Note that full details may not be displayed until a short time prior to checkin.
4 properties
ChargeCalculated
object
An object representing a charge. Information about the charge is provided in both the billable currency and the request currency.
2 properties
BillingContactRequestWithPhone
object
4 properties 3 required
Itinerary
object
The itinerary object.
17 properties
Field
object
An individual field that had an error.
3 properties
Frequency
string
The frequency of when this applies.
PaymentRequestWithPhone
object
8 properties 2 required
ThirdPartyAuthRequest
object
9 properties 4 required
Stay
object
3 properties
EssentialInformation
object
Essential information, including the supply contact information and any other essential information.
3 properties
NonrefundableDateRange
object
2 properties
RoomItineraryLinks
object
A map of links - cancel - Cancel the booking for this room change - A PUT call to modify the details of the booking for this room (soft change) shopforchange -…
3 properties
CancelPenalty
object
6 properties
Adjustment
object
Any price adjustments associated with this itinerary.
3 properties
RoomHistoryItem
object
A room history event, representing a change made to a specific room.
23 properties
CancelRefund
object
The refund information for cancelling the itinerary.
2 properties
TraderRightToWithdrawMessage
string
The trader right to withdraw message.
Conversations
object
Details about initiating conversations.
1 property
ValueAdd
object
An individual value add.
6 properties
BillingContactRequestAddress
object
7 properties 1 required
PromotionsItinerary
object
Promotions that apply to the booked room.
1 property
Charge
object
An object representing a charge. Information about the charge is provided in both the billable currency and the request currency.
2 properties
Address_1
object
7 properties
CategoryValueAdd
string
The general category that this value add promotion falls into.
PricingInformation
object
The pricing information object.
4 properties
Image_1
object
3 properties
NightCharge
object
3 properties
PhoneRequest
object
The entire phone number must be represented across the three fields in this object. The entire phone number should not exceed 25 characters.
3 properties 2 required
CommitChangeRoomRequestBody
object
2 properties
StayType
string
The price breakout type.
Phone
object
The entire phone number must be represented across the three fields in this object.
3 properties
TraderContactMessage
string
The trader contact message.
StatusItinerary
string
The booking status of the room.
Essential
object
4 properties
RateHistory
object
The rate information associated with the itinerary.
5 properties
RateItinerary
object
The rate information associated with the itinerary.
12 properties
ChangeRoomDetailsRequest
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

expedia-group-manage-booking-api-openapi.yml Raw ↑

Other APIs Expedia Group publishes across the network.

Expedia Group Bookings API
Expedia Group Content API
Expedia Group Deposit API
Expedia Group Geography API
Expedia Group Loyalty API
Expedia Group Notifications API
Expedia Group OrderPurchaseScreen API
Expedia Group OrderPurchaseUpdate API
Expedia Group Property API
Expedia Group Rate Plan API
Expedia Group Rate Verification Thresholds API
Expedia Group Room Type Amenities API