Skip to content
Last updated

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 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
reservationsRequired. Array containing exactly one reservation ID. Multiple reservations are not currently supported.
booker.countryRequired. ISO country code of the booker.
currencyOptional. Returns monetary amounts in the requested currency where applicable.

Example request

{
  "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
reservationReservation identifier.
affiliateAffiliate ID associated with the booking.
statusCurrent booking status.
pickup/ dropoffPickup and dropoff location, date/time, depot information, and instructions.
durationRental duration in days, when available.
carVehicle details including make and model, supplier, pricing, and rental policies.
productsOptional ancillary products added to the booking, such as GPS devices or child seats.
insuranceInsurance products purchased as part of the booking.
driverPrimary 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

{
  "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
cancelledThe order has been cancelled and is no longer active.
confirmedThe reservation is confirmed by the supplier and is active.
not_confirmedThe order request exists but has not yet been confirmed by the supplier.
quoteA quotation has been generated but the reservation has not been placed.
completedThe rental has finished and can no longer be cancelled.
processingThe reservation is being processed; payment or final confirmation is pending.
unknownThe reservation status is unknown or not available.

Next steps