# 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](/assets/overview-1.05973a0b1ce35393c92f672d0c692f9810f54322e03b45b43369ee468b452264.5e2a7131.jpg)

## 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:

| Endpoint | Description |
|  --- | --- |
| [/orders/preview](/demand/docs/open-api/3.2/demand-api/orders/orders/preview) | Retrieve the final price, available payment methods, and booking information before confirming the reservation. |
| [/orders/create](/demand/docs/open-api/3.2/demand-api/orders/orders/create) | Create the order and process payment using the order token returned by /orders/preview. |


Learn how to use these endpoints in the [Orders creation guide](/demand/docs/orders-api/order-preview-create).

### Retrieve post-booking details

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

| Endpoint | Description |
|  --- | --- |
| [/orders/details/accommodations](/demand/docs/open-api/3.2/demand-api/orders/orders/details/accommodations) | Retrieve 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](/demand/docs/open-api/3.2/demand-api/orders/orders/details/cars) and  [/orders/details/cars/live](/demand/docs/open-api/3.2-beta/demand-api/orders/details/cars/live) | Retrieve car rental order details including pick-up information, order status, driver details (where available), and attribution labels. |
| [/orders/details/flights](/demand/docs/open-api/3.2/demand-api/orders/orders/details/accommodations) | Retrieve 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

| Endpoint | Description |
|  --- | --- |
| [/orders/cancel](/demand/docs/open-api/3.2/demand-api/orders/orders/cancel) | Cancel an eligible reservation and retrieve the cancellation result. |
| [/orders/modify](/demand/docs/orders-api/order-modify) | Modify 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.

| Endpoint | Description |
|  --- | --- |
| [/orders/details](/demand/docs/open-api/3.2/demand-api/orders/orders/details) | Retrieve order information created or updated within a specified time period to support reporting, reconciliation, attribution, and customer operations. |


See the [Reporting and reconciliation guide](/demand/docs/orders-api/order-details/) for implementation details and examples.

## Key features

### Preview before booking

The [/orders/preview endpoint](/demand/docs/open-api/3.2/demand-api/orders/orders/preview) 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](/demand/docs/accommodations/prices-accommodations) 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](/demand/docs/payments/overview/#overview) for integration guidance and implementation best practices.

## Related guides

* [Create orders](/demand/docs/orders-api/order-preview-create) – Learn how to use /orders/preview and /orders/create.
* [Modify orders](/demand/docs/orders-api/order-modify) - Learn how to use /orders/modify and /orders/modify/preview in Beta.
* [Cancel orders](/demand/docs/orders-api/cancel-order) - Learn all about cancellations, and cancellation policies.
* [Retrieve post-booking details](/demand/docs/orders-api/order-details-service) – Access service-specific booking information for accommodations, cars, and flights.
* [Reporting and reconciliation](/demand/docs/orders-api/order-details) – Retrieve order data across travel services for reporting and operational workflows.
* [Payments quick guide](/demand/docs/payments/how-to) – Learn how to determine available payment methods and timings before creating an order.