Getting startedBooking Retrieval and Booking Confirmation API

Integration overview

Welcome!

This topic introduces you to these integrations:

  • Booking Retrieval (BR)
  • Booking Confirmation (BC)

If you are looking for information about additional APIs’ capabilities, such as Products, Availability and Rates Retrieval (PARR), or Product API, refer to the overview page.

Important links:

  • Booking Retrieval request and response) schemas, which define the standard and format for consistent retrieval of bookings, modifications, and cancellations
  • Booking Confirmation request and response) schemas, which define the standard and format to generate confirmation numbers for travelers booking through Expedia Group points of sale

The list of changes made to the API are included in the revision history.

Integration project timeline

AR BookingRetrieval

Integration overview

You can retrieve booking information and send confirmation numbers through the Booking Retrieval and Booking Confirmation APIs as follows:

  1. Booking Retrieval integration retrieves bookings, modifications, and cancellations
  2. Booking Confirmation integration then sends the property’s confirmation number to Expedia Group
Requirements
  • All XML index and content files must be well-formed, adhere to the schema (XSD), and be encoded in UTF-8 (UTF-8 required if you support Unicode names and special requests).
  • Use the endpoints supplied by Expedia Group. TLS 1.2 is required.
  • Be secured using basic authentication.
Steps to enable online bookings
  1. The partner submits a form to advise Expedia Group that you would like to adopt the Booking Retrieval and Booking Confirmation API
  2. An Expedia Group Connectivity Account Manager contacts the partner to set priorities and determine needs.
  3. The Integration team and Expedia Group Connectivity Manager schedules a kick-off call, where partners meet their Integration Specialist and review desired settings and address API questions, issues, and expectations.
  4. The partner develops Booking Retrieval and Booking Confirmation integrations for accepting and managing online reservations.
  5. The partner encodes Booking Retrieval and Booking Confirmation responses in UTF-8
  6. The partner ensures the Booking Retrieval service sends updates for changes to online bookings created on Expedia Group points of sale.
  7. The partner works with the Integration team to test and validate use cases.
  8. On-going maintenance and support as needed

More details are provided in the Development requirements.

Integration testing

When you are ready to test, contact the Expedia Group Integration Specialist assigned to your account for access to the guides and testing tools.

Testing for this API consists of self-tests using test properties. You will retrieve test bookings in a live production environment. When you have tested as much as possible with the test property, contact your Integration Specialist to begin a soft launch.

At this point, you will be able to complete live testing on a real property. You will monitor the live property for seven days and will report any errors or warnings they receive to your Integration Specialist. You and your Integration Specialist will ensure all reservations have been received and confirmed.

When you confirm that all reservations have been received and confirmed, the Integration Specialist will email you to let you know that the soft launch has been successfully completed.

After launch
  • You must continue to adhere to our Terms and Conditions
  • Each partner must retrieve and confirm bookings with these integrations
XML structure

This section provides an overview of the Booking Retrieval and Booking Confirmation schemas, which define the structure of the XML files that you must provide to retrieve bookings from Expedia Group points of sale and provide your confirmation numbers.

  • Booking Retrieval
  • Booking Confirmation
Booking Retrieval

These files allow you to call bookings made on Expedia Group points of sale. Requests include:

  • Each property’s unique Expedia Group identifier
  • Booking IDs

brbc api documentation mapping image9

Responses include:

  • Bookings
  • Expedia booking ID
  • Property (hotel) ID
  • Room and rate plan IDs
  • Dates of stay
  • Guest count
  • Per day rates
  • Total including taxes
  • Payment card if applicable
  • Primary guest information
  • Reward programs, if applicable
  • Special requests, if applicable

brbc api documentation mapping image11

Booking Confirmation

This file allows you to return booking confirmation numbers for reservations made on Expedia Group points of sale. Requests include:

  • Each property’s unique Expedia Group identifier
  • Booking confirmation numbers (from the property)
  • Booking ID (each booking’s unique Expedia Group identifier)
  • Time and date confirmed

brbc api documentation mapping image2

Responses include:

  • Success/Error and messaging
  • Booking ID (each booking’s unique Expedia Group identifier)
  • Booking confirmation number (from the property)

brbc api documentation mapping image10