# Monitor and display live car order details Beta

**Learn how to retrieve and display the latest status and operational details for an existing car rental booking.**

## Overview

Use the [/orders/details/cars/live](/demand/docs/open-api/3.2-beta/demand-api/orders/details/cars/live) endpoint to retrieve the latest information for an existing car rental reservation after creating an order.

Unlike the booking response returned by /orders/create, this endpoint provides the current booking status together with the latest operational information from Booking.com and the car rental supplier.

Use it to monitor bookings while they are being processed and to display the latest booking information before vehicle pickup.

Use this endpoint to:

* Monitor booking confirmation.
* Display the latest booking details.
* Retrieve the supplier confirmation number.
* Access insurance details and documents.
* Display the latest cancellation and pickup information.


This endpoint is currently available as a **Beta** feature for evaluation purposes. It is temporary and will be deprecated once its functionality is incorporated into the primary **/orders/details/cars** endpoint in the next stable version.

## Post-booking workflow

Post booking live car order details
The following steps explain how to monitor an order after it has been created and how to display the latest order information to travellers.

## Before you begin

Before calling this endpoint, ensure you have:

* The reservation ID returned by /orders/create.
* The booker's country.
* Your affiliate credentials.


Optionally, provide a currency to convert monetary amounts into the traveller's preferred display currency.

## Step 1 — Request live booking details

→ Call **/orders/details/cars/live** using the reservation ID returned when creating the order.

### Example request

```json
{
  "reservations": [
    "11223344"
  ],
  "booker": {
    "country": "nl"
  },
  "currency": "USD"
}
```

The endpoint currently supports **one reservation per request**.

## Step 2 — Check the booking status

Always inspect the `status` field before displaying booking information.

Possible values include:

| Status | Description |
|  --- | --- |
| `processing` | The booking is still being processed. Final confirmation is not yet available. |
| `confirmed` | The booking has been confirmed by the supplier. |
| `not_confirmed` | The booking request was not confirmed. |
| `cancelled` | The booking has been cancelled. |
| `completed` | The rental has finished. |
| `unknown` | The booking status cannot currently be determined. |


Receiving an HTTP 200 response means the request completed successfully, **not** that the booking has been confirmed.

Immediately after calling /orders/create, bookings typically remain in the `processing` state while Booking.com completes supplier confirmation.

## Step 3 — Display booking details

Use the response to update the traveller's booking page with the latest information, including:

* Vehicle information.
* Pickup and drop-off details.
* Pricing and payment information.
* Rental policies.
* Supplier confirmation number.
* Optional extras.


Some booking information may change after the reservation is created. Always retrieve live booking details before displaying pickup instructions, pricing or cancellation policies.

## Step 4 — Display insurance details

If insurance was purchased, use the `insurance` object to display policy information and any available insurance documents.

* Insurance product.
* Insurance status.
* Policy reference.
* Insurance price.
* Available insurance documents.


Each insurance object always includes the following document types:

| Document | Description |
|  --- | --- |
| `policy_document` | Full insurance policy and terms. |
| `ipid` | Insurance Product Information Document. |
| `certificate` | Certificate of Insurance issued after policy confirmation. |


The Certificate of Insurance is only available after the insurance policy has been confirmed.
Certificate URLs are temporary (approximately 10 minutes) and should **not** be stored. Call this endpoint again whenever you need a fresh download URL.

Each document reports its own retrieval status:

* `available`
* `temporarily_unavailable`
* `unavailable`


This allows your application to display available documents while handling unavailable documents independently.

See the [Insurance guide](/demand/docs/cars/3.2/cars-insurance-guide) for full details.

## Step 5 — Monitor order confirmation

A newly created booking may remain in the `processing` state for a short period while Booking.com completes supplier confirmation.

During this time:

* The supplier confirmation number may not yet be available.
* Insurance policies may still be pending.
* Insurance documents may return `temporarily_unavailable`.


Continue polling this endpoint until the booking reaches a final state, such as `confirmed`, `not_confirmed`, or `cancelled`.

## Best practices

* Always check the booking `status` before displaying confirmation to the traveller.
* Treat `processing` as a normal intermediate state after creating an order.
* Do not assume a booking is confirmed immediately after calling /orders/create.
* Continue polling until the booking reaches a final state such as `confirmed` or `not_confirmed` (or `cancelled`).
* Retrieve live booking details before displaying pickup instructions, pricing or cancellation policies.
* Display the supplier confirmation number when it becomes available.
* Do not store Certificate of Insurance URLs.
* Handle each insurance document according to its individual retrieval status.
* Use the latest response instead of relying on data captured during booking.


## Related guides

* [Car rental order details reference](/demand/docs/orders-api/order-details-cars) - See the endpoint detailed description.
* [Car rental insurance guide](/demand/docs/cars/3.2/cars-insurance-guide) - Learn how to display insurance information and documents returned by live booking details.
* [Cancel orders](/demand/docs/orders-api/cancel-order) - Learn how to cancel eligible car rental bookings.