{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["admonition","tabs","tab"]},"type":"markdown"},"seo":{"title":"Car rental quick guide","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-quick-guide","__idx":0},"children":["Car rental quick guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Follow this quick guide to start playing with our Car rental API collection in your client application"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This quick guide shows the minimum steps needed to integrate the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/cars"},"children":["Demand API car rental endpoints"]}," in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Search, look and redirect flow"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"card","style":{"flex":"1","minWidth":"300px"}},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["⏱️ Estimated time to complete:"]}," 15 - 30 minutes ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Purpose:"]}," Fast setup to search, retrieve car rental details, display results and redirect for booking."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["When to use:"]}," You’re not familiar with the Car rental APIs and want to try it quickly."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integration:"]}," Search, look and redirect flow (with URL booking redirection)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You´ll learn how to:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search for car rentals."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve results and car rental details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display results."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Redirect to book car rental."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Code samples:"]}," Minimal, only required fields."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":1},"children":["Before you start"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you start, make sure you’ve completed the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/getting-started/try-out-the-api#before-you-start---prerequisites"},"children":["prerequisites"]},"."," ","You’ll need:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✓ A ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/authentication/#api-key-management"},"children":["valid API key token"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✓ Your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Affiliate-Id"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✓ Open the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/getting-started/try-out-the-api#try-out-console"},"children":["try out console"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-case","__idx":2},"children":["Use case"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This use case represents a typical Cars API scenario:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["A traveller visiting your website wants to add car rental for their upcoming holiday in Edinburgh, Scotland"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["They want to book a medium sized car for 8 days"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["The traveller is in the Netherlands and is using your website from their mobile phone"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To get familiar with the Car API flow and the endpoints involved, take this use case as an example in every step of this guide."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not forget to authenticate every call that you make to our endpoints by using your API key - Token and your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Affiliate-Id"]}," parameter."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For more information, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/authentication/"},"children":["Authentication and authorisation"]}," section."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1---search-for-vehicles","__idx":3},"children":["Step 1 - Search for vehicles"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["→ Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/cars/search"},"children":["/search"]}," request to let travellers search for car rentals and look at the price and list of available vehicles for the route they are interested on."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search-request","__idx":4},"children":["Search request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are the key parameters to create your search request (valid for both 3.1 and 3.2 versions)."]},{"$$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":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"100px"}},"children":["Key parameters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Description"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recommendation"]}]},{"$$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":["Specify the country from which the search request is made.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["This is required to ensure that the response complies with relevant laws on the display of taxes and fees."]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Get your two-letter country code using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/commonlocations/common/locations/countries"},"children":["List countries"]}," endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In this case for the use case provided, use (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nl"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Note: The country code must always be in lowercase."]}]}]}]},{"$$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":["Specify the three-letter code that uniquely identifies the country's monetary currency."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For this example, you will use \"EUR\" as the traveller is in the Netherlands.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can check the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.iban.com/currency-codes","target":"_blank"},"children":["full list of currency codes here"]},"."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["driver.age"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This field determines if age related fees are required or not."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If the customer’s age is known, send the actual age (Must be a number between 18 and 99)",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If age is unknown, prompt the traveller to select a default age range or submit their age outside this range."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route.pickup"]},"/ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropoff"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specify the traveller's requested pickup and dropoff dates and times."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use the YYYY-MM-DDTHH:MM:SS."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route.pickup/ dropoff.location"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specify location where pickup/dropoff is taking place."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use the IATA three-letter code to identify an airport. In this case, would be: ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["EDI"]}," for Edimburgh airport.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find your ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.iata.org/en/publications/directories/code-search/","target":"_blank"},"children":["IATA codes here"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Or add the latitude/longitude coordinates (see example below)"]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Location"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Locations can be specified using airport IATA codes, city IDs, or latitude/longitude coordinates."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the provided ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["use case"]}," you should create a request body similar to this example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"booker\": {\n    \"country\": \"nl\"\n  },\n  \"currency\": \"EUR\",\n  \"driver\": {\n    \"age\": 36\n  },\n  \"route\": {\n    \"pickup\": {\n      \"datetime\": \"2026-09-01T10:00:00\",\n      \"location\": {\n        \"airport\": \"EDI\"\n      }\n    },\n    \"dropoff\": {\n      \"datetime\": \"2026-09-08T11:05:00\",\n      \"location\": {\n        \"airport\": \"EDI\"\n      }\n    }\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example with latitude and longitude coordinates:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"booker\": {\n    \"country\": \"nl\"\n  },\n  \"currency\": \"EUR\",\n  \"driver\": {\n    \"age\": 36\n  },\n  \"route\": {\n    \"pickup\": {\n      \"datetime\": \"2026-09-01T10:00:00\",\n      \"location\": {\n        \"coordinates\": {\n          \"latitude\": 52.309456,\n          \"longitude\": 4.762266\n        }\n      }\n    },\n    \"dropoff\": {\n      \"datetime\": \"2026-09-08T11:05:00\",\n      \"location\": {\n        \"coordinates\": {\n          \"latitude\": 52.309456,\n          \"longitude\": 4.762266\n        }\n      }\n    }\n  }\n}\n\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["→ ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/cars/search"},"children":["Try it yourself"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Reference"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/search-for-cars"},"children":["Cars search guide"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/search-cars-examples"},"children":["Use cases"]}," for best practices."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response contains a list of vehicles that match the specified search criteria. For each vehicle in the list, the response contains:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"3.1 response","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this case, 3.1 version response has these parameters:"]},{"$$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":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"150px"}},"children":["Key parameters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$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":["The car’s unique identifier (id).",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep this ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," to see further car details in next steps."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains promotional deal details when available, including discount percentage, deal tags, and the original (public) price.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If no deal applies, the value is \"null\"."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Includes the policies applied on cancellations, fuel, mileage and payment.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the given example, there is a free cancellation policy valid up to 7 days (P7D) before pickup."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.payment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-timings"},"children":["timing"]}," when the payment takes place.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the provided example, it is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_now"]}," (but could be pay local, or pay later)."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The total price for each vehicle that is available for the specified search criteria.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["By default, the price is shown in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}," specified in the body request (e.g. EUR for nl)."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route.pickup"]},"/ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropoff"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["depot id"]}," is retrieved in both the pickup and dropoff fields."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Supplier id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You can use this id in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/cars-quick-guide#step-2-get-details"},"children":["step 2"]}," to get further details about a specific supplier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["URL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The links point to the relevant Booking App search page, and cars.booking.com search page.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In both cases, the URLs contain your affiliate id (aid) (in the example xxxxx) so when redirecting travellers to the booking in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-4-redirect-the-customer-to-complete-the-booking"},"children":["step 4"]},", it can be attributed to you."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["next_page"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All results are ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/pagination"},"children":["paginated"]}," for better readability."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"3.2 response","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The 3.2 version includes these parameters in response"]},{"$$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":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"150px"}},"children":["Key parameters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$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":["The car’s unique identifier, now representing a specific car model + supplier (fleet) combination.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep this ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," to see further car details in next steps."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A unique identifier for this specific car rental offer.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Required for availability checks in the /cars/availability endpoint and orders/preview and orders/create in case you are implementing the Search, look and book flow."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["car_categories"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The categories of the car (e.g., small, medium, large, suvs, estate, premium, carriers).",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Helps classify the car for UI or business logic."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains promotional deal details when available, including discount percentage, deal tags, and the original (public) price.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If no deal applies, the value is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Includes the policies applied on cancellations, fuel, mileage, payment, deposits, damage and theft excess.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Monetary fields (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deposit"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["damage_excess"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["theft_excess"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mileage.amount"]},") are objects with amount and currency."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the example, there is a free cancellation policy valid up to 7 days (P7D) before pickup."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.payment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The timing when the payment takes place.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Updated enum values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_partial_online_now"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_at_pickup"]},"."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The total price for each vehicle that is available for the specified search criteria.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Includes all extra charges, shown in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}," requested (EUR in example)."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route.pickup"]},"/ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropoff"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["depot id"]}," is retrieved in both the pickup and dropoff fields.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["depot_location_type"]}," may also be provided."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Supplier"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You can use this id to get further details about a specific supplier via cars/details endpoint - Use this id for ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/cars-quick-guide#step-2-get-details"},"children":["step 2"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The links point to the relevant Booking App search page, and cars.booking.com search page.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Both URLs include your affiliate ID (aid) (in the example xxxxx) so when redirecting travellers to the booking in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-4-redirect-the-customer-to-complete-the-booking"},"children":["step 4"]},", it can be attributed to you."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["next_page"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All results are ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/pagination"},"children":["paginated"]}," for better readability."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response v3.2:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01h00fr9y7qkbxtc6kyv97j49z\",\n  \"data\": [\n    {\n      \"car\": 122655,\n      \"offer\": \"803765581\",\n      \"car_categories\": [\"large\", \"suvs\"],\n      \"deal\": null,\n      \"policies\": {\n        \"cancellation\": {\n          \"type\": \"free_cancellation\",\n          \"details\": {\n            \"context\": \"before_pickup\",\n            \"duration\": \"P7D\"\n          }\n        },\n        \"fuel\": \"return_same\",\n        \"mileage\": {\n          \"amount\": 10.0,\n          \"currency\": \"EUR\",\n          \"distance\": 50,\n          \"distance_unit\": \"km\",\n          \"type\": \"limited\"\n        },\n        \"payment\": {\n          \"timing\": \"pay_online_now\"\n        },\n        \"deposit\": {\n          \"amount\": 1500,\n          \"currency\": \"EUR\"\n        },\n        \"damage_excess\": {\n          \"amount\": 3000,\n          \"currency\": \"EUR\"\n        },\n        \"theft_excess\": {\n          \"amount\": 3000,\n          \"currency\": \"EUR\"\n        },\n        \"insurance_package\": \"basic\"\n      },\n      \"price\": {\n        \"total\": \"50.00\",\n        \"currency\": \"EUR\",\n        \"extra_charges\": [\n          { \"charge\": \"aged_driver_fee\", \"total_amount\": 21.9 },\n          { \"charge\": \"one_way_fee\", \"total_amount\": 50.0 }\n        ]\n      },\n      \"route\": {\n        \"pickup\": { \"depot\": 112314 },\n        \"dropoff\": { \"depot\": 112314 }\n      },\n      \"supplier\": 7455,\n      \"url\": {\n        \"app\": \"booking://search?affiliate_id=xxxxx&driver_age=25&do_time=2026-06-22T10:00&do_loc_iata=MAN&pu_time=2026-06-20T10:00&pu_loc_iata=LHR&pu_loc_name=London+Heathrow+Airport&expand_search=false\",\n        \"web\": \"https://cars.booking.com/search-results?vehicleId=699340901&vehicleInfo.vehicle.id=699340901&aid=xxxxx&prefcurrency=USD&preflang=en&driversAge=25&doHour=10&doMinute=0&doDay=22&doMonth=6&doYear=2026&dropLocationIata=MAN&puHour=10&puMinute=0&puDay=20&puMonth=6&puYear=2026&locationIata=LHR&locationName=London+Heathrow+Airport\"\n      }\n    }\n  ],\n  \"metadata\": {\n    \"next_page\": \"eyJhbGciOiJIUzI1NiJ9.eyJwIjp7Im1heGltdW1fcmVzdWx0cyI6MTAsIm9mZnNldCI6MTB9LCJhdWQiOiJDQVJTX1NVUFBMSUVSUyIsImV4cCI6MTY4MzY0NzMwNX0.y7NmH48mm7lImd2WxsHdotj6n-dVQAzJCGCnIJCKy3A\",\n    \"total_results\": 122\n  },\n  \"search_token\": \"eyJhbGciOiJIUzI1NiJ9.eyJwIjp7ImJvb2tlciI6eyJjb3VudHJ5IjoidXMifX0sImF1ZCI6Ii9ob3RlbHMvc2VhcmNoIiwiZXhwIjoxNzUwMDAwMDAwfQ.XYZ123AbcDefGHIjklMNOpqrsTUVwxYZ456789\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note: The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_token"]}," expires after 90 mins."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2---retrieve-car-details","__idx":5},"children":["Step 2 - Retrieve car details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you show the search results to the traveller, you need to get additional content about each vehicle, the supplier and the depot(s)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can do it in two different ways:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["a) Using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/cars-static-data"},"children":["stored static data"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["b) Alternatively you can call the static data endpoints:"]},{"$$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":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use it to ..."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/cars/details"},"children":["/cars/details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get additional information about the available vehicles."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/cars/suppliers"},"children":["/cars/suppliers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return the list of available cars suppliers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/cars/depots"},"children":["/cars/depots"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For information about the pickup and dropoff locations returned in the cars/search response."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/cars/constants"},"children":["/cars/constants"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For localised car rental constants (e.g., fuel types, transmission, payment timings)."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Reference"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note: These endpoints remain unchanged between versions 3.1 and 3.2. It continues to be used to fetch static car information such as capacity, make, model, and specifications, etc."," ","See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/retrieve-car-details"},"children":["Cars details guide"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/cars-static-data"},"children":["Static data"]}," for best practices."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3---display-your-search-results-page","__idx":6},"children":["Step 3 - Display your search results page"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You now have the necessary information to display the search results to the traveller."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use data from both the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/cars-quick-guide#step-1-search-for-available-vehicles"},"children":["cars/search"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/cars-quick-guide#step-2-get-details"},"children":["car/details"]}," responses to provide the level of detail suited to your business needs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"recommendations","__idx":7},"children":["Recommendations"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"limiting-the-number-of-results","__idx":8},"children":["Limiting the number of results"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To improve the search experience, consider limiting the maximum number of results displayed."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"last_modified\": \"2026-12-01T11:05:00+00:00\",\n  \"maximum_results\": 100\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"keeping-content-up-to-date","__idx":9},"children":["Keeping content up-to-date"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For static content (e.g., data from the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/retrieve-car-details/#/cars/details"},"children":["car/details endpoint"]},"), we recommend checking the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_modified"]}," timestamp to ensure the information is up-to-date."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Timestamps follow the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.iso.org/iso-8601-date-and-time-format.html","target":"_blank"},"children":["ISO 8601"]}," standard, with the format: YYYY-MM-DDTHH:MM:SSZ (UTC only)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"show-supplier-logo","__idx":10},"children":["Show supplier logo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When displaying supplier results, consider showing the supplier’s logo alongside their name."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This helps travellers easily recognise the supplier and makes their decision-making process smoother."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"display-scores","__idx":11},"children":["Display scores"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We also recommend showing the total score, as well as the breakdown of scores for each depot, on the search results page."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This can significantly aid the traveller in their booking decision."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Reference"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/retrieve-car-details"},"children":["Look at details"]}," guide for best practices."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4---redirect-the-traveller-to-complete-the-booking","__idx":12},"children":["Step 4 - Redirect the traveller to complete the booking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After a traveller has chosen the vehicle they want to book, you should redirect them to the URL (either app or web link) returned in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/cars-quick-guide#step-1-search-for-available-vehicles"},"children":["/search response"]},"."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/cars-quick-guide#step-1-search-for-available-vehicles"},"children":["/search response"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the returned Booking URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Redirect the traveller to the selected URL."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"url\": {\n  \"app\": \"booking://search?affiliate_id=xxxxx&driver_age=25&do_time=2026-06-22T10:00&do_loc_iata=MAN&pu_time=2026-06-20T10:00&pu_loc_iata=LHR&pu_loc_name=London+Heathrow+Airport&expand_search=false\",\n  \"web\": \"https://cars.booking.com/search-results?vehicleId=699340901&vehicleInfo.vehicle.id=699340901&aid=xxxxxxx&prefcurrency=USD&preflang=en&driversAge=25&doHour=10&doMinute=0&doDay=22&doMonth=6&doYear=2026&dropLocationIata=MAN&puHour=10&puMinute=0&puDay=20&puMonth=6&puYear=2026&locationIata=LHR&locationName=London+Heathrow+Airport\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Curious to know more?"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/retrieve-car-details"},"children":["Search guide"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/search-cars-examples"},"children":["Use cases"]}," for examples and best practices."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ready to migrate your integration? Check out our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/migration-guide/v3.2/changes"},"children":["Migration guide"]}," to smoothly transition to 3.2 Demand API car rental."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ready for the full Search, look and book flow? Follow the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/3.2/cars-tutorial"},"children":["end to end tutorial"]},"."]}]}]}]},"headings":[{"value":"Car rental quick guide","id":"car-rental-quick-guide","depth":1},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"Use case","id":"use-case","depth":2},{"value":"Step 1 - Search for vehicles","id":"step-1---search-for-vehicles","depth":2},{"value":"Search request","id":"search-request","depth":3},{"value":"Step 2 - Retrieve car details","id":"step-2---retrieve-car-details","depth":2},{"value":"Step 3 - Display your search results page","id":"step-3---display-your-search-results-page","depth":2},{"value":"Recommendations","id":"recommendations","depth":3},{"value":"Limiting the number of results","id":"limiting-the-number-of-results","depth":4},{"value":"Keeping content up-to-date","id":"keeping-content-up-to-date","depth":4},{"value":"Show supplier logo","id":"show-supplier-logo","depth":4},{"value":"Display scores","id":"display-scores","depth":4},{"value":"Step 4 - Redirect the traveller to complete the booking","id":"step-4---redirect-the-traveller-to-complete-the-booking","depth":2}],"frontmatter":{"title":"Car rental quick guide","description":"Follow this quick guide to integrate the Demand API cars collection. Learn how to search vehicles, retrieve details, display results, and redirect travellers to book car rentals.","tags":["cars","car rentals","quick start","search, look and redirect","demand api"],"api":["/search","/cars/details","/cars/depots","/cars/suppliers"],"keywords":["car rental quick guide","cars API guide","demand API cars","search car rentals","book car rentals","car suppliers","car depots","booking cars"],"x-redocly":{"seo":{"title":"Car Rentals API quick start – Demand API v3.1","description":"Step-by-step guide to using the Demand API v3.1 cars endpoints. Learn how to search, get details, display results, and redirect travellers to complete car rental bookings."},"audience":["developer","partner","integrator"],"apiVersion":"v3.1, v3.2","product":["cars"]},"seo":{"title":"Car rental quick guide"}},"lastModified":"2026-07-31T13:32:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/cars/3.2/cars-quick-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}