{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Car rental order details","siteUrl":"https://developers.booking.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"car-rental-order-details","__idx":0},"children":["Car rental order details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieve-car-rental-order-details","__idx":1},"children":["Retrieve car rental order details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["→ Use the /orders/details/cars/live to retrieve detailed information for a car rental booking by reservation ID."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Beta"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2-beta/demand-api/orders/details/cars/live"},"children":["/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."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request supports the following fields:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"110px"}},"children":["Parameter"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required. Array containing exactly one reservation ID. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Multiple reservations are not currently supported"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker.country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required. ISO country code of the booker."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional. Returns monetary amounts in the requested currency where applicable."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request","__idx":2},"children":["Example request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"reservations\": [\n    \"11223344\"\n  ],\n  \"booker\": {\n    \"country\": \"nl\"\n  },\n  \"currency\": \"USD\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response","__idx":3},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common fields include:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"110px"}},"children":["Parameter"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reservation identifier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["affiliate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Affiliate ID associated with the booking."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Current booking status."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup"]},"/ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropoff"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pickup and dropoff location, date/time, depot information, and instructions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["duration"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rental duration in days, when available."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["car"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Vehicle details including make and model, supplier, pricing, and rental policies."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional ancillary products added to the booking, such as GPS devices or child seats."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["insurance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Insurance products purchased as part of the booking."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["driver"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Primary driver details when PII sharing is enabled."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"vehicle-and-pricing-information","__idx":4},"children":["Vehicle and pricing information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The car object contains detailed information about the booked vehicle, including:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Vehicle category and make/model."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Number of seats and doors."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transmission type."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Air conditioning availability."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Luggage capacity."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supplier information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pricing details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Rental policies."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pricing includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["base"]}," – Base rental price after promotions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pre_discount_base"]}," – Original price before discounts."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," – One or more total amounts grouped by payment timing (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_at_pickup"]},")."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rental-policies","__idx":5},"children":["Rental policies"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["car.policies"]}," object provides important information required before pickup, including:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refundable security deposit."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fuel policy."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mileage policy."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Detailed cancellation schedule and applicable fees."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cancellation policies may contain multiple time periods with different fees. When a cancellation fee has not yet been determined, the corresponding ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}," value may be null."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"optional-extras","__idx":6},"children":["Optional extras"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}," array contains ancillary services added to the booking, such as:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Additional driver."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GPS navigation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Child or booster seats."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wi-Fi devices."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Snow equipment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Other supplier-specific extras."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each product includes its type, selected quantity, pricing information, and charging model (for example, per rental or per day)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"insurance","__idx":7},"children":["Insurance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When insurance has been purchased, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["insurance"]}," array contains:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Insurance product name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Current status."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Price."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policy_reference"]},"- Unique identifier for the insurance policy."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Did you know?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policy_reference"]}," when contacting customer support or when requesting cancellation of an insurance policy."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"personally-identifiable-information-pii","__idx":8},"children":["Personally Identifiable Information (PII)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When PII sharing is enabled for your integration, the response may include details of the primary driver, including:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["driver.name"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["driver.email"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["driver.telephone"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If these fields are not returned, your integration may not have the required permissions enabled."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-response","__idx":9},"children":["Example response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01fr9ez700exycb98w90w5r9sh\",\n  \"data\": [\n    {\n      \"affiliate\": 1234567,\n      \"reservation\": \"11223344\",\n      \"status\": \"confirmed\",\n      \"duration\": 3,\n      \"pickup\": {\n        \"datetime\": \"2025-10-15T10:00:00Z\",\n        \"location\": \"Dublin Airport\"\n      },\n      \"dropoff\": {\n        \"datetime\": \"2025-10-18T10:00:00Z\",\n        \"location\": \"Dublin Airport\"\n      },\n      \"car\": {\n        \"make_and_model\": \"Toyota Corolla\",\n        \"category\": \"Compact\",\n        \"supplier\": {\n          \"name\": \"Avis\"\n        },\n        \"price\": {\n          \"total\": [\n            {\n              \"display\": {\n                \"value\": 110.00,\n                \"currency\": \"USD\"\n              },\n              \"pay\": {\n                \"value\": 100.00,\n                \"currency\": \"EUR\",\n                \"timing\": \"pay_online_now\"\n              }\n            }\n          ]\n        },\n        \"policies\": {\n          \"fuel_policy\": \"return_same\",\n          \"mileage\": {\n            \"type\": \"unlimited\"\n          }\n        }\n      },\n      \"products\": [\n        {\n          \"type\": \"additional_driver\",\n          \"selected_quantity\": 1\n        }\n      ],\n      \"insurance\": [\n        {\n          \"name\": \"Full Protection\",\n          \"policy_reference\": \"4e9d5e7c-c11d-41ee-9f77-cb2508104199\",\n          \"status\": \"confirmed\"\n        }\n      ]\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"order-status","__idx":10},"children":["Order status"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"110px"}},"children":["Order status"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancelled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The order has been cancelled and is no longer active."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The reservation is confirmed by the supplier and is active."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_confirmed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The order request exists but has not yet been confirmed by the supplier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quote"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A quotation has been generated but the reservation has not been placed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The rental has finished and can no longer be cancelled."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The reservation is being processed; payment or final confirmation is pending."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unknown"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The reservation status is unknown or not available."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":11},"children":["Next steps"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Learn ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/cancel-order"},"children":["how to cancel car rental orders"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Learn ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/3.2/cars-insurance-guide"},"children":["how to manage purchased insurance policies"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Explore ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/order-details-accommodations"},"children":["accommodation"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/order-details-flights"},"children":["flight order details"]}," guides if your integration supports multiple travel verticals."]}]}]}]},"headings":[{"value":"Car rental order details","id":"car-rental-order-details","depth":1},{"value":"Retrieve car rental order details","id":"retrieve-car-rental-order-details","depth":2},{"value":"Example request","id":"example-request","depth":3},{"value":"Response","id":"response","depth":2},{"value":"Vehicle and pricing information","id":"vehicle-and-pricing-information","depth":3},{"value":"Rental policies","id":"rental-policies","depth":3},{"value":"Optional extras","id":"optional-extras","depth":3},{"value":"Insurance","id":"insurance","depth":3},{"value":"Personally Identifiable Information (PII)","id":"personally-identifiable-information-pii","depth":3},{"value":"Example response","id":"example-response","depth":3},{"value":"Order status","id":"order-status","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Car rental order details"}},"lastModified":"2026-06-15T16:26:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/orders-api/order-details-cars","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}