# Car rental order details

**Use /orders/details/cars to retrieve basic car rental order information. Use /orders/details/cars/live (Beta) to retrieve enriched booking details including vehicle information, supplier details, pricing, rental policies, ancillary products, insurance, pickup instructions, and (where permitted) primary driver information**.

## Retrieve car rental order details

→ Use the /orders/details/cars/live to retrieve detailed information for a car rental booking by reservation ID.

Beta
[/orders/details/cars/live](/demand/docs/open-api/3.2-beta/demand-api/orders/details/cars/live) is a temporary endpoint introduced in Demand API v3.2 to provide enhanced order details. Its functionality will be incorporated into /orders/details/cars in a future stable release.

The request supports the following fields:

| Parameter | Description |
|  --- | --- |
| `reservations` | Required. Array containing exactly one reservation ID. **Multiple reservations are not currently supported**. |
| `booker.country` | Required. ISO country code of the booker. |
| `currency` | Optional. Returns monetary amounts in the requested currency where applicable. |


### Example request

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

## Response

The response returns a data array containing the requested reservation. Although the response is structured as an array, the current endpoint supports retrieving a single reservation per request.

Common fields include:

| Parameter | Description |
|  --- | --- |
| `reservation` | Reservation identifier. |
| `affiliate` | Affiliate ID associated with the booking. |
| `status` | Current booking status. |
| `pickup`/ `dropoff` | Pickup and dropoff location, date/time, depot information, and instructions. |
| `duration` | Rental duration in days, when available. |
| `car` | Vehicle details including make and model, supplier, pricing, and rental policies. |
| `products` | Optional ancillary products added to the booking, such as GPS devices or child seats. |
| `insurance` | Insurance products purchased as part of the booking. |
| `driver` | Primary driver details when PII sharing is enabled. |


### Vehicle and pricing information

The car object contains detailed information about the booked vehicle, including:

* Vehicle category and make/model.
* Number of seats and doors.
* Transmission type.
* Air conditioning availability.
* Luggage capacity.
* Supplier information.
* Pricing details.
* Rental policies.


Pricing includes:

* `base` – Base rental price after promotions.
* `pre_discount_base` – Original price before discounts.
* `total` – One or more total amounts grouped by payment timing (for example, `pay_online_now` or `pay_at_pickup`).


### Rental policies

The `car.policies` object provides important information required before pickup, including:

* Refundable security deposit.
* Fuel policy.
* Mileage policy.
* Detailed cancellation schedule and applicable fees.


Cancellation policies may contain multiple time periods with different fees. When a cancellation fee has not yet been determined, the corresponding `price` value may be null.

### Optional extras

The `products` array contains ancillary services added to the booking, such as:

* Additional driver.
* GPS navigation.
* Child or booster seats.
* Wi-Fi devices.
* Snow equipment.
* Other supplier-specific extras.


Each product includes its type, selected quantity, pricing information, and charging model (for example, per rental or per day).

### Insurance

When insurance has been purchased, the `insurance` array contains:

* Insurance product name.
* Current status.
* Price.
* `policy_reference`- Unique identifier for the insurance policy.


Did you know?
Use the `policy_reference` when contacting customer support or when requesting cancellation of an insurance policy.

### Personally Identifiable Information (PII)

When PII sharing is enabled for your integration, the response may include details of the primary driver, including:

* `driver.name`
* `driver.email`
* `driver.telephone`


If these fields are not returned, your integration may not have the required permissions enabled.

### Example response

```json
{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": [
    {
      "affiliate": 1234567,
      "reservation": "11223344",
      "status": "confirmed",
      "duration": 3,
      "pickup": {
        "datetime": "2025-10-15T10:00:00Z",
        "location": "Dublin Airport"
      },
      "dropoff": {
        "datetime": "2025-10-18T10:00:00Z",
        "location": "Dublin Airport"
      },
      "car": {
        "make_and_model": "Toyota Corolla",
        "category": "Compact",
        "supplier": {
          "name": "Avis"
        },
        "price": {
          "total": [
            {
              "display": {
                "value": 110.00,
                "currency": "USD"
              },
              "pay": {
                "value": 100.00,
                "currency": "EUR",
                "timing": "pay_online_now"
              }
            }
          ]
        },
        "policies": {
          "fuel_policy": "return_same",
          "mileage": {
            "type": "unlimited"
          }
        }
      },
      "products": [
        {
          "type": "additional_driver",
          "selected_quantity": 1
        }
      ],
      "insurance": [
        {
          "name": "Full Protection",
          "policy_reference": "4e9d5e7c-c11d-41ee-9f77-cb2508104199",
          "status": "confirmed"
        }
      ]
    }
  ]
}
```

## Order status

| Order status | Description |
|  --- | --- |
| `cancelled` | The order has been cancelled and is no longer active. |
| `confirmed` | The reservation is confirmed by the supplier and is active. |
| `not_confirmed` | The order request exists but has not yet been confirmed by the supplier. |
| `quote` | A quotation has been generated but the reservation has not been placed. |
| `completed` | The rental has finished and can no longer be cancelled. |
| `processing` | The reservation is being processed; payment or final confirmation is pending. |
| `unknown` | The reservation status is unknown or not available. |


## Next steps

* Learn [how to cancel car rental orders](/demand/docs/orders-api/cancel-order).
* Learn [how to manage purchased insurance policies](/demand/docs/cars/3.2/cars-insurance-guide).
* Explore [accommodation](/demand/docs/orders-api/order-details-accommodations) and [flight order details](/demand/docs/orders-api/order-details-flights) guides if your integration supports multiple travel verticals.