# Orders

This API collection enables **management of booking orders** within the Demand API.</br>Use these endpoints to:</br>- Preview and create new orders.</br>- Check order details.</br>- Cancel or modify existing orders.</br>This collection is required to integrate booking and order management functionality.

## Preview an order

 - [POST /orders/preview](https://developers.booking.com/demand/docs/open-api/3.2/demand-api/orders/orders/preview.md): Use this endpoint to calculate the final price, including a detailed price breakdown, payment schedule, and cancellation policies for accommodation and car rentals.
Provide the booker's details and preferred currency to receive personalised pricing.
For accommodations:
Include check-in and check-out dates.
Include room allocations and selected products.
For cars:
Include the offer ID and search token.
Optionally include an insurance quote_reference (from /cars/availability) to attach third-party insurance.

## Create an order

 - [POST /orders/create](https://developers.booking.com/demand/docs/open-api/3.2/demand-api/orders/orders/create.md): Use this endpoint to confirm the order and proceed the payment.

## Orders details

 - [POST /orders/details](https://developers.booking.com/demand/docs/open-api/3.2/demand-api/orders/orders/details.md): Use this endpoint to fetch detailed information about existing orders across accommodations, cars, flights, attractions, and taxis. Useful for syncing your system with Booking.com order data, monitoring updates, and performing reporting or analytics across services.

You can query orders by:
- Creation or update date — retrieve orders created or updated within a 7-day range.
- Travel dates — filter by start or end date (up to 7 days).
- Order or reservation ID — fetch details for specific orders.

Notes:
- Only one filter type (created, updated, start, end, orders, reservations, page) should be provided per request.
- 'currency' must be a three-letter ISO 4217 code. Defaults to product base currency if omitted.
- 'extras' can request additional data (currently supports 'payment').
- 'services' allows filtering by travel service type (accommodations, cars, flights, attractions, taxis).

This endpoint is ideal for:
- Displaying booking details in partner dashboards or traveller confirmation pages.
- Generating invoices, receipts, or post-booking communications.
- Performing reporting, reconciliation, or analytics across all travel services.
 See the Order reporting guide for more details.

## Orders with accommodation details

 - [POST /orders/details/accommodations](https://developers.booking.com/demand/docs/open-api/3.2/demand-api/orders/orders/details/accommodations.md): Use this endpoint to retrieve detailed information for one or more accommodation orders.You can request order details either by reservation or order ID depending on your integration.
- The response includes all key information for each order, including booking status, pricing, commission, cancellation details, and optional extras.
- Results are sorted by order creation date in descending order, with the most recently booked orders listed first.

## Orders with car details

 - [POST /orders/details/cars](https://developers.booking.com/demand/docs/open-api/3.2/demand-api/orders/orders/details/cars.md): Use this endpoint to retrieve detailed information for one or more car rental orders.

- You can request car order details using your reservation ID.
- The response includes booking and cancellation details, commission, pricing, and optional extras (for example, policies).
- Results are sorted by the date of order creation in descending order, with the most recently booked orders listed first.

## Orders with flight details

 - [POST /orders/details/flights](https://developers.booking.com/demand/docs/open-api/3.2/demand-api/orders/orders/details/flights.md): Use this endpoint to retrieve detailed information for one or more flight orders.

- You can request flight order details either by order ID or by reservation ID.
- The response includes structured order data, including pricing, itinerary segments with IATA airport codes, etc.

This endpoint is ideal for:
- Displaying flight booking details in traveller dashboards or confirmation pages.
- Generating post-booking communications and invoices.
- Performing reporting or reconciliation tasks that require accurate itinerary and pricing data.

## Modify an order

 - [POST /orders/modify](https://developers.booking.com/demand/docs/open-api/3.2/demand-api/orders/orders/modify.md): Use this endpoint to modify certain aspects of an accommodation order, such as credit card details, checkin/checkout dates, and room configurations (guest allocation, guest names, and smoking preferences). See the Orders modification guide for examples and best practices.

## Preview order modification

 - [POST /orders/modify/preview](https://developers.booking.com/demand/docs/open-api/3.2/demand-api/orders/orders/modify/preview.md): Preview whether a requested modification can be applied to an order and retrieve the expected cost impact before confirming the change.

Use this endpoint to:

- Check if the requested modification can be applied.
- Review the updated total cost (for accommodation changes).

Note: This endpoint does not apply any changes to the order.

## Cancel an order

 - [POST /orders/cancel](https://developers.booking.com/demand/docs/open-api/3.2/demand-api/orders/orders/cancel.md): Use this endpoint to cancel a reservation within an existing order. Provide the reservation details for the travel service you want to cancel. You can optionally include the order ID to help identify the order. Only one reservation can be cancelled per request.

For step-by-step instructions, examples, and best practices, see the Cancellations guide.