Skip to content
API REFERENCES/
/Orders

Preview an order

Request

Use this endpoint to validate an order before checkout and 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, room allocation, and selected products.

For cars: Include the offer ID and search token. Optionally include selected optional products (such as GPS or child seats) returned by /cars/availability to add extras, and/or an insurance.quote_reference from /cars/availability to attach third-party insurance.

Security
BearerAuth
Headers
X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/jsonrequired
One of:

Use this option to preview pricing and policies for car rentals.

carobject(OrdersPreviewCarInput)

Additional information related to the car order. This field is mutually exclusive with accommodation; only one of them can be included in a request.

accommodationobject(OrdersPreviewAccommodationInput)

Input parameter with the checkin and checkout date and all the accommodation products to be ordered. This field is mutually exclusive with car; only one of them can be included in a request.

currencystring or null(currencyId)^[A-Z]{3}$

A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling common/payments/currencies.

Example:"EUR"
curl -i -X POST \
  https://demandapi.booking.com/3.3/orders/preview \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "currency": "EUR",
    "car": {
      "offer": 123456789,
      "search_token": "eyJhbGciOiJIUzI1NiJ9.eyJwIjp7ImJvb2tlciI6eyJjb3VudHJ5IjoidXMifX0sImF1ZCI6Ii9ob3RlbHMvc2VhcmNoIiwiZXhwIjoxNzUwMDAwMDAwfQ.XYZ123AbcDefGHIjklMNOpqrsTUVwxYZ456789",
      "products": [
        {
          "id": "001234567890",
          "amount": 1
        }
      ],
      "insurance": {
        "quote_reference": "38ddeef-a7fb-4e24-a1e2-66fc3af23d76#1t0juiba8h6n2"
      }
    }
  }'

Responses

Successful response.

Bodyapplication/json
request_idstring(requestId)

Uniquely identifies the request. Please provide this identifier when contacting support.

dataPreview car order response (object) or Preview accommodation order response (object)(OrdersPreviewDataOutput)
One of:

Contains the calculated order details for accommodation or car products, including pricing, policies, etc.

Response
{
  "request_id": "string",
  "data": {
    "car": { … },
    "order_token": "sample-order-token-1234"
  }
}