Lodging overview

The Lodging Shopping and Booking APIs work together to enable a full end-to-end booking experience

Shopping APIs

The XAP Lodging Shopping APIs can be used by partners both booking via an Expedia website or those booking via the XAP APIs. Each API also provides pre-configured links to the Expedia website, the XAP Booking API, or both.

API	Description	Required?	Who should use it?
Listings	Search Expedia lodging inventory by Location Keyword, Region ID, Lat/Long, or Hotel ID(s) and return up to 1,000 offers per response. Provides deeplink to the Expedia site to book, or rate plan info to enable API booking.	Yes	All partners looking to integrate with our API should use the listings API, whether you’re doing a link-off or a Shop through Book integration.
Details	Extended information about the rate, charges, fees, and financial terms associated with booking a single lodging rate plan offer.	No	Partners that want to provide in-depth lodging location data to customers.
Rate Calendar	The Rate Calendar API will return the lowest rate plan for a range of days for one selected Expedia lodging property.	No	Partners that want to provide a rate calendar to customers.
Quotes	The Lodging Quotes API will return the price and availability information for given Expedia lodging property ID(s).	No	Partners that want to provide price and availability information to customers.
Availability Calendars	Returns the availability of each day for a range of dates for given Expedia lodging properties.	No	Partners that want to provide the availability of each day to customers.

Booking APIs

These APIs will only be used by partners leveraging the XAP APIs to book lodging offers that are delivered in the XAP Lodging Details API response.

API	Description	Required?	Who should use it?
Booking	Enables up to 8 rooms in a single property to be booked on behalf of a customer.	Yes (Unless booking via Expedia website.)	Partners that want to enable Expedia bookings to be transacted without requiring the customer to leave the partner site.
Resume Booking	Enables 2-step Authentication Process.	No	Partners that want to enable purchases via PayPal or 3DS-enabled credit cards.

Booking Management APIs

These APIs can be leveraged by any partner, but in order to access booked itineraries the partner will either have to be in possession of data that was only available at the time of booking, or provide a means for the booked traveler to input the required booking data.

All bookings (whether by Expedia website or API) can be canceled on the Expedia website where it was booked, or via a call to Expedia Customer Service.

API	Description	Required?	Who should use it?
Booking Retrieve	Retrieves the details of an Expedia booking (whether booking was done via Booking API or on the Expedia website).	No	Partners that are providing booked travel info to customers, or else qualifying partners that need access to customer booking data for reporting.
PreCancel	Determines whether an itinerary can be canceled via the API, what penalties might apply, and the timelines associated with those. Requires data that is only available at time of booking, so you can only cancel trips that you have booked.	No	Partners that want to determine whether a specific customer booking is cancellable via the API and what penalties apply.
Cancel	Cancels an existing booking. Requires data that is only available at time of booking, so you will only be able to cancel trips that you have booked.	No	Partners that want to provide trip cancellation for customers who booked via the Booking API.