Skip to content
Last updated

Orders management

Use the /orders endpoints to let travellers book and pay for travel services directly from your application, then retrieve and manage order details throughout their lifecycle without redirecting users to Booking.com.


The /orders API collection

API collection is part of the Demand API and provides the endpoints required to support the complete booking lifecycle and post-booking capabilities within your application:

Create orders – Confirm availability, review pricing and payment options, and create orders for supported travel services.

Manage orders – Retrieve post-booking information, cancel eligible bookings, and perform supported modifications.

Support reporting and reconciliation – Retrieve order data across travel services for reporting, commission reconciliation, attribution, and operational workflows.

Important

As part of our Connected Trip offering, the /orders API collection supports multiple travel services — including accommodations and car rentals.

Use the /orders endpoints if your integration supports any of the following application flows:

drawing

Key endpoints

The following endpoints support the full lifecycle of an order — from order creation to post-booking management and reporting.

Create an order

These endpoints allow you to validate availability, review the price and payment options, and create an order:

EndpointDescription
/orders/previewRetrieve the final price, available payment methods, and booking information before confirming the reservation.
/orders/createCreate the order and process payment using the order token returned by /orders/preview.

Learn how to use these endpoints in the Orders creation guide.

Retrieve post-booking details

Use the service-specific /orders/details/* endpoints to retrieve detailed information about individual orders.

EndpointDescription
/orders/details/accommodationsRetrieve accommodation-specific details (e.g. check-in time, policies, status and labels). You may want this, for example, to assist a customer with an enquiry.
/orders/details/cars and /orders/details/cars/liveRetrieve car rental order details including pick-up information, order status, driver details (where available), and attribution labels.
/orders/details/flightsRetrieve flight booking details such as itinerary information and reservation status.

These endpoints can power traveller-facing experiences such as Manage My Booking pages and support operational workflows including customer support, commission reconciliation, and loyalty integrations.

Cancel and modify orders

EndpointDescription
/orders/cancelCancel an eligible reservation and retrieve the cancellation result.
/orders/modifyModify supported aspects of an existing booking, such as dates or payment details where applicable.

Reporting and reconciliation

Use a single endpoint to retrieve information about multiple orders across travel services for reporting and operational purposes.

EndpointDescription
/orders/detailsRetrieve order information created or updated within a specified time period to support reporting, reconciliation, attribution, and customer operations.

See the Reporting and reconciliation guide for implementation details and examples.

Key features

Preview before booking

The /orders/preview endpoint helps improve the booking experience by:

  • Returning the final price and available payment methods for the selected products.
  • Generating an order token that encapsulates the validated booking information. Pass this token to /orders/create to complete the booking without rebuilding the request.

See the Pricing guide for more details.

Payment support

The Demand API supports a range of payment models and methods to accommodate different integration scenarios.

The /orders API collection provides:

  • Information about available payment methods.
  • Payment timing and collection details.
  • Support for the payment flow associated with the selected booking.

Explore the Payments documentation for integration guidance and implementation best practices.