# Live Car order details

Returns enriched, live car order details for a specific reservation, including vehicle, supplier, pricing, insurance, policy, and driver information.

This endpoint is currently available as a beta feature for evaluation and testing purposes.

The endpoint is temporary and will be deprecated once its functionality is incorporated into the primary /orders/details/cars endpoint.

Endpoint: POST /orders/details/cars/live
Version: 3.2-Beta
Security: BearerAuth

## Header parameters:

  - `X-Affiliate-Id` (integer, required)
    Include here your Affiliate identifier number

## Request fields (application/json):

  - `currency` (string | null)
    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

  - `reservations` (array, required)
    List of reservation IDs to retrieve live car order details for. Currently limited to a single reservation per request.

  - `booker` (object, required)
    Information about the person who made the booking. Required for car order details.

  - `booker.country` (string, required)
    A two-letter code that uniquely identifies a country. This code is defined by the ISO 3166-1 alpha-2 standard (ISO2) as described here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2. The full list can be obtained by calling common/locations/countries.
    Example: nl

## Response 200 fields (application/json):

  - `request_id` (string)
    Uniquely identifies the request. Please provide this identifier when contacting support.

  - `data` (array)
    List of car order objects for the requested reservations.

  - `data.affiliate` (integer)
    The affiliate ID used for this order.

  - `data.car` (object | null)
    Vehicle, supplier, pricing, and policy details.

  - `data.car.id` (integer | null)
    Unique identifier of the booked vehicle. Corresponds to the car field returned by /cars/search and the id field returned by /cars/details.

  - `data.car.image` (string | null)
    Relative path to the car image. Combine this path with the CDN base URL to retrieve the image. May be null if no image is available.

  - `data.car.category` (string | null)
    Category of the car (e.g., 'Compact', 'SUV').

  - `data.car.transmission` (string | null)
    Transmission type (e.g., 'Automatic', 'Manual').

  - `data.car.doors` (string | null)
    Number of doors.

  - `data.car.seats` (string | null)
    Number of seats.

  - `data.car.air_conditioning` (boolean | null)
    Whether the car has air conditioning.

  - `data.car.big_suitcase` (string | null)
    Number of large suitcases the car can accommodate.

  - `data.car.small_suitcase` (string | null)
    Number of small suitcases the car can accommodate.

  - `data.car.currency` (string | null)
    Currency code for pricing (e.g., 'EUR', 'USD').

  - `data.car.make_and_model` (string | null)
    Make and model of the car (e.g., 'Toyota Corolla').

  - `data.car.special_offer` (string | null)
    The special offer included with this product, if any. This can be an additional service, a free upgrade, or a promotional feature provided by the supplier. If no special offer applies, the value is null.

  - `data.car.supplier` (object | null)
    Car rental supplier (company) information.

  - `data.car.supplier.id` (string | null)
    Unique identifier of the supplier.

  - `data.car.supplier.name` (string | null)
    Name of the car rental supplier (e.g., 'Avis', 'Hertz').

  - `data.car.supplier.telephone` (string | null)
    Contact telephone number for the pickup location.

  - `data.car.supplier.confirmation_number` (string | null)
    Supplier's confirmation/reference number for the booking.

  - `data.car.price` (object | null)
    Pricing breakdown for the car rental.

  - `data.car.price.base` (object | null)
    Price amounts for display and payment.

  - `data.car.price.base.display` (object | null)
    Monetary amount with currency and payment timing.

  - `data.car.price.base.display.value` (number | null)
    The monetary value.

  - `data.car.price.base.display.currency` (string | null)
    The ISO 4217 currency code (e.g., 'EUR', 'USD').

  - `data.car.price.base.display.timing` (string)
    The applied payment timing. For example 'pay_online_now'.
    Enum: "pay_online_now", "pay_at_pickup"

  - `data.car.price.total` (array | null)
    List of total prices broken down by payment timing (pay now vs pay at pickup).

  - `data.car.policies` (object | null)
    General policies applicable to the car rental.

  - `data.car.policies.mileage` (object | null)
    Mileage policy information.

  - `data.car.policies.mileage.distance_limit` (number | null)
    Maximum distance allowed when mileage is limited.

  - `data.car.policies.mileage.distance_unit` (string | null)
    Unit of distance measurement.
    Enum: "kilometers", "miles"

  - `data.car.policies.mileage.amount` (number | null)
    Cost per unit of distance if mileage is limited.

  - `data.car.policies.mileage.currency` (string | null)
    Currency for the mileage overage charge.

  - `data.car.policies.mileage.type` (string | null)
    Type of mileage policy.
    Enum: "limited", "unlimited"

  - `data.car.policies.fuel_policy` (string)
    Fuel policy applied to the rental.
    Enum: "return_same", "return_same_or_prepay_no_refunds", "return_same_preauth", "free_tank", "prepay_no_refunds", "prepay_part_refunds", "prepay_refunds", "unknown"

  - `data.car.policies.cancellation` (object)
    Cancellation policy information.

  - `data.car.policies.cancellation.type` (string | null)
    Type of cancellation policy.
    Enum: "free_cancellation", "non_refundable"

  - `data.car.policies.cancellation.schedule` (array | null)
    Chronological list of cancellation periods with their applicable fees. Each entry represents a contiguous time window and its cancellation conditions. Periods are ordered by start time and expressed in UTC. When present, the schedule fully describes the cancellation policy.

  - `data.car.policies.cancellation.schedule.from` (string)
    Start date and time of this cancellation period in ISO-8601 format.

  - `data.car.policies.cancellation.schedule.to` (string)
    End date and time of this cancellation period in ISO-8601 format.

  - `data.car.policies.cancellation.schedule.free_cancellation` (boolean)
    Indicates whether cancellation is free during this period. When true, no cancellation fee applies. In case is false and the price is null, the fee is pending and will be typically determined 48h before pickup.

  - `data.dropoff` (object | null)
    Pickup or dropoff location details.

  - `data.dropoff.datetime` (string | null)
    Pickup/dropoff date and time in ISO-8601 format.

  - `data.dropoff.location` (string | null)
    Pickup/dropoff location name.

  - `data.dropoff.depot_type` (string | null)
    Location type of the depot (e.g., 'Airport', 'Downtown').

  - `data.dropoff.depot_id` (string | null)
    Unique identifier of the depot.

  - `data.dropoff.instructions` (string | null)
    Pickup or dropoff instructions at this location.

  - `data.products` (array)
    Optional ancillary services added to the car hire order (for example, additional driver, child seat, or GPS).

  - `data.products.id` (string | null)
    Unique identifier for this product/extra.

  - `data.products.type` (string | null)
    Type of extra product.
    Enum: "additional_driver", "baby_seat", "bluetooth_handsfree_kit", "booster_seat", "child_booster_seat", "child_seat", "child_seat_isofix", "etc_card_electronic_toll_collection_card", "excess_protection", "fast_track", "gps", "infant_seat", "luggage_rack", "personal_travel_assistant", "queue_jump", "roof_rack", "ski_box", "ski_rack", "skierized_equipment", "snow_chains", "snow_tyres", "wifi_mobile", "wifi_router"

  - `data.products.selected_quantity` (integer | null)
    Number of this product selected/booked.

  - `data.products.mode` (string | null)
    Pricing mode for this product.
    Enum: "each_per_day", "each_per_rental", "per_day", "per_rental"

  - `data.reservation` (string)
    The reservation ID for this car order.

  - `data.duration` (integer | null)
    Duration of the car rental in days.

  - `data.driver` (object | null)
    Details of the primary driver associated with the booking.

  - `data.driver.name` (string)
    Full name of the driver.

  - `data.driver.email` (string)
    Email address of the driver.

  - `data.driver.telephone` (string)
    Driver’s phone number.

  - `data.status` (string)
    Current status of the car order.
    Enum: "cancelled", "confirmed", "not_confirmed", "quote", "completed", "processing", "unknown"

  - `data.insurance` (array | null)
    Insurance products purchased as part of the car rental booking. Returns null if no insurance was purchased.

  - `data.insurance.id` (string)
    Unique identifier for the insurance type.
    Example: 335

  - `data.insurance.name` (string)
    Name of the insurance product (in English by default)
    Example: Full Protection

  - `data.insurance.price` (object | null)
    Insurance price amounts for display and payment. Payment timing is not applicable.

  - `data.insurance.price.display` (object | null)
    Monetary amount with currency for insurance prices.

  - `data.insurance.price.display.value` (number | null)
    The monetary value.

  - `data.insurance.price.display.currency` (string | null)
    The ISO 4217 currency code (e.g., 'EUR', 'USD').

  - `data.insurance.policy_reference` (string)
    Unique reference identifier for the issued insurance policy. This field is omitted while status is new and returned once the policy is issued. Use this reference when contacting customer support or requesting cancellation of the policy.
    Example: 4e9d5e7c-c11d-41ee-9f77-cb2508104199

  - `data.insurance.status` (string)
    Current status of an insurance policy.
    Enum: "new", "confirmed", "cancelled"

  - `data.insurance.documents` (array, required)
    Insurance documents associated with this policy. Documents are retrieved independently, and each document reports its own retrieval status. Failure to retrieve one or more documents does not cause the request to fail. This array is always returned when an insurance object is present and always contains exactly three entries — one for each supported document type (policy_document, ipid, certificate) — even when a document could not be retrieved (in which case its url is null).

  - `data.insurance.documents.name` (string, required)
    The insurance document type.
    Enum: "policy_document", "ipid", "certificate"

  - `data.insurance.documents.url` (string | null, required)
    URL of the insurance document when status is available; otherwise null.
    Example: https://staging.rentalcover.com/en/pds/WXXG-CVHM-INS

  - `data.insurance.documents.status` (string, required)
    Retrieval status of this document.
    Enum: "available", "unavailable", "temporarily_unavailable"

## Response 400 fields (application/json):

  - `request_id` (string, required)
    Uniquely identifies the request. Please provide this identifier when contacting support.

  - `errors` (array, required)

  - `errors.id` (string, required)

  - `errors.message` (string, required)

## Response 500 fields (application/json):

  - `request_id` (string, required)
    Uniquely identifies the request. Please provide this identifier when contacting support.

  - `errors` (array, required)

  - `errors.id` (string, required)

  - `errors.message` (string, required)