# Orders management

**Use the /orders endpoints to let travellers book and pay for travel services and products directly from your application. Manage bookings efficiently without redirecting users to Booking.com.**

## The /orders API collection

The /orders API collection is part of the Demand API and enables full booking and post-booking capabilities within your application:

✅ **Booking** – Let travellers confirm and pay for the travel products they’ve selected, including accommodation and car rentals.

✅ **Post-booking** – Retrieve and manage bookings, cancellations, and other follow-up actions such as reporting commissions or handling loyalty programmes.

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.8338b8b76fc478b62dee6100ddee023d481daddb5fdcc7b484945ec7af0bca37.5e2a7131.png)

## Key endpoints

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

### Create an order

These endpoints allow you to confirm availability, review the final price and payment options, and create a booking:

| Endpoint | Description |
|  --- | --- |
| [/orders/preview](/demand/docs/open-api/demand-api/orders/orders/preview) | Retrieve the final price, available payment methods, and other booking details. |
| [/orders/create](/demand/docs/open-api/demand-api/orders/orders/create) | Confirm the booking and process payment using the data provided by /orders/preview. |


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

### Retrieve order details

Access booking information to support customer queries or carry out post-booking operations:

| Endpoint | Description |
|  --- | --- |
| [/orders/details](/demand/docs/open-api/demand-api/orders/orders/details) | Get general information about a list of orders, created or updated whithin specific dates. |
| [/orders/details/accommodations](/demand/docs/open-api/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/demand-api/orders/orders/details/cars) | Retrieves details about the car rental specific part of the order including their status or labels used (needed for attribution) |
| [/orders/details/flights](/demand/docs/open-api/demand-api/orders/orders/details/accommodations) | Retrieves details about the flights specific part of the order. |


See [/orders/details/ guide](/demand/docs/orders-api/order-details/) for usage instructions.

### Cancel and modify orders

| Endpoint | Description |
|  --- | --- |
| [/orders/cancel](/demand/docs/open-api/demand-api/orders/orders/cancel) | Cancel an existing booking and retrieve the cancellation result. |
| [/orders/modify](/demand/docs/orders-api/order-modify) | Modify certain details from an existing order (example: Checkin/checkout dates or Credit card details.) |


## Key features

### Preview before booking

The [/orders/preview endpoint](/demand/docs/open-api/demand-api/orders/orders/preview) improves the user experience and reduces errors by:

* Returning the [final price](/demand/docs/accommodations/prices-accommodations) and available [payment methods](/demand/docs/payments/overview/#how-to-use-payments), tailored to the selected products.
* Generating a unique **order token**, which encapsulates all relevant booking details. You pass this token to [/orders/create endpoint](/demand/docs/open-api/demand-api/orders/orders/create) to complete the order — no need to rebuild the request manually.


### Extensive payment options

The Demand API supports a wide range of payment features to meet both partner and traveller needs.

The /orders API collection provides:

* Clear information on payment timing and methods.
* Built-in support to help you handle each payment flow — from collection to processing.


Explore the [Payments section](/demand/docs/payments/overview/#overview) for integration guidance and best practices.

Curious to know more?
* Find dedicated guidelines in the [Orders section](/demand/docs/orders-api/overview).
* Check out all available [payment methods](/demand/docs/payments/payments-methods) and [timings](/demand/docs/payments/payments-timings).
* Use the [Payments quick guide](/demand/docs/payments/how-to) for initial instructions on how to check available payment options.
* Review the [payment use cases](/demand/docs/payments/payments-examples) for examples and best practices.