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.
→ Use the /orders/details/cars/live to retrieve detailed information for a car rental booking by reservation ID.
/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. |
{
"reservations": [
"11223344"
],
"booker": {
"country": "nl"
},
"currency": "USD"
}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. |
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_noworpay_at_pickup).
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.
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).
When insurance has been purchased, the insurance array contains:
- Insurance product name.
- Current status.
- Price.
policy_reference- Unique identifier for the insurance policy.
Use the policy_reference when contacting customer support or when requesting cancellation of an insurance policy.
When PII sharing is enabled for your integration, the response may include details of the primary driver, including:
driver.namedriver.emaildriver.telephone
If these fields are not returned, your integration may not have the required permissions enabled.
{
"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 | 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. |
- Learn how to cancel car rental orders.
- Learn how to manage purchased insurance policies.
- Explore accommodation and flight order details guides if your integration supports multiple travel verticals.