# Live Car order details

Returns enriched, live car order details for a specific reservation. This endpoint is intended for partner use cases that require full car, supplier, pricing, and driver information. It is a temporary endpoint and will be deprecated once these changes are merged into the primary /orders/details/cars endpoint in v3.3.

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)
    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.

  - `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.

## 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)
    Details of the rented vehicle, including supplier, pricing and policies.

  - `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)
    URL of the car image.

  - `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.supplier` (object,null)
    Car hire supplier 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 information for the car rental.

  - `data.car.price.base` (object,null)
    Base price of the vehicle (excluding extras), after any promotions.

  - `data.car.price.base.display` (object,null)
    Amount displayed to the traveller, converted to the requested currency when applicable.

  - `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.base.pay` (object,null)
    The amount the traveller will pay in the supplier's currency.

  - `data.car.price.base.pay.value` (number,null)
    The monetary value.

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

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

  - `data.car.price.pre_discount_base` (object,null)
    Base price before discount.

  - `data.car.price.pre_discount_base.display` (object,null)
    Amount displayed to the traveller, converted to the requested currency when applicable.

  - `data.car.price.pre_discount_base.display.value` (number,null)
    The monetary value.

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

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

  - `data.car.price.pre_discount_base.pay` (object,null)
    The amount the traveller will pay in the supplier's currency.

  - `data.car.price.pre_discount_base.pay.value` (number,null)
    The monetary value.

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

  - `data.car.price.pre_discount_base.pay.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.price.total.display` (object,null)
    Amount displayed to the traveller, converted to the requested currency when applicable.

  - `data.car.price.total.display.value` (number,null)
    The monetary value.

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

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

  - `data.car.price.total.pay` (object,null)
    The amount the traveller will pay in the supplier's currency.

  - `data.car.price.total.pay.value` (number,null)
    The monetary value.

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

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

  - `data.car.policies` (object,null)
    Applicable policies including deposit, mileage, fuel, and cancellation.

  - `data.car.policies.deposit` (object,null)
    Refundable security deposit required at pickup.

  - `data.car.policies.deposit.value` (number,null)
    The monetary value.

  - `data.car.policies.deposit.currency` (string,null)
    The ISO 4217 currency code (e.g., 'EUR', 'USD').

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

  - `data.car.policies.mileage` (object,null)
    Mileage policy details.

  - `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 details.

  - `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.car.policies.cancellation.schedule.price` (object,null)
    Cancellation fee for this period. Null when fee has not yet been determined.

  - `data.car.policies.cancellation.schedule.price.display` (object,null)
    Amount displayed to the traveller, converted to the requested currency when applicable.

  - `data.car.policies.cancellation.schedule.price.display.value` (number,null)
    The monetary value.

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

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

  - `data.car.policies.cancellation.schedule.price.pay` (object,null)
    The amount the traveller will pay in the supplier's currency.

  - `data.car.policies.cancellation.schedule.price.pay.value` (number,null)
    The monetary value.

  - `data.car.policies.cancellation.schedule.price.pay.currency` (string,null)
    The ISO 4217 currency code (e.g., 'EUR', 'USD').

  - `data.car.policies.cancellation.schedule.price.pay.timing` (string)
    The applied payment timing. For example 'pay_online_now'.
    Enum: "pay_online_now", "pay_at_pickup"

  - `data.dropoff` (object,null)
    Drop-off location and time 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.pickup` (object,null)
    Pick-up location and time details.

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

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

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

  - `data.pickup.depot_id` (string,null)
    Unique identifier of the depot.

  - `data.pickup.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.products.price` (object,null)
    Price of this extra product.

  - `data.products.price.display` (object,null)
    Amount displayed to the traveller, converted to the requested currency when applicable.

  - `data.products.price.display.value` (number,null)
    The monetary value.

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

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

  - `data.products.price.pay` (object,null)
    The amount the traveller will pay in the supplier's currency.

  - `data.products.price.pay.value` (number,null)
    The monetary value.

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

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

  - `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. Only returned when PII sharing is enabled.

  - `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"