{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Migrate from v3.1 to Demand API v3.2","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"migrate-from-v31-to-demand-api-v32","__idx":0},"children":["Migrate from v3.1 to Demand API v3.2"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this guide to migrate your existing Demand API v3.1 car rental integration to v3.2. Review the endpoint, schema, field, and integration-flow changes that can affect your implementation."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"migration-overview","__idx":1},"children":["Migration overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Demand API v3.2 standardises car rental schemas and naming conventions and aligns the Cars API collection more closely with patterns used across other Demand API travel services."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The main migration changes include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Significant request and response changes to /cars/search."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Naming and field changes in /cars/depots."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Updated payment timing identifiers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Minor consistency improvements across existing Cars endpoints."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Additional car rental booking and post-booking capabilities available in Beta."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Direct car rental booking and selected post-booking capabilities are currently available in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Beta only"]},". You do not need to implement these capabilities to migrate an existing Search, look and redirect integration from v3.1 to v3.2."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint-migration-overview","__idx":2},"children":["Endpoint migration overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the following table to identify which existing endpoints require changes."]},{"$$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":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Change"},"children":["Change"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Migration action"},"children":["Migration action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/cars/search"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Significant request and response schema changes."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review and update your integration. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/migration-guide/v3.2/cars/search"},"children":["/cars/search migration guide"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/cars/depots"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field naming and consistency updates."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update renamed fields and remove dependencies on fields no longer returned."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/cars/depots/reviews/scores"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No significant integration changes."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No migration action required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/cars/suppliers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No significant integration changes."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No migration action required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/cars/constants"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Updated payment timing identifiers."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review mappings or logic that depend on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_timings.id"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/cars/details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No significant integration changes."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No migration action required."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This table covers endpoints available to an existing v3.1 integration. New Beta endpoints and booking capabilities are described separately below."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"breaking-changes","__idx":3},"children":["Breaking changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070c9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["v3.2"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#ff6600","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["Changed"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"white","color":"black","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px","border":"2px solid #FF0000"}},"children":["Breaking change"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"carssearch","__idx":4},"children":["/cars/search"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["/cars/search introduces the most significant schema changes between v3.1 and v3.2."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depending on your integration, you may need to update:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request fields and structures."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response parsing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pricing and policy structures."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Route and location information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Offer and search-context handling."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Other fields consumed by your application."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/migration-guide/v3.2/cars/search"},"children":["/cars/search migration guide"]}," for detailed v3.1-to-v3.2 mappings and examples."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"carsdepots","__idx":5},"children":["/cars/depots"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["/cars/depots remains functionally similar in v3.2, but some field names and structures have been standardised."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Review the following changes:"]},{"$$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":"v3.1"},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#6B7280","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["v3.1"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"v3.2"},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["v3.2"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Migration action"},"children":["Migration action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pick_up"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update references to use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["drop_off"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropoff"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update references to use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropoff"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deskAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Removed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove dependencies on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deskAt"]}," and use the relevant depot location information instead."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Update any data models, response parsers, mappings, or downstream logic that depend on the v3.1 field names."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payment-timing-identifiers","__idx":6},"children":["Payment timing identifiers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Demand API v3.2 standardises the Cars payment timing identifiers."]},{"$$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":"v3.1"},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#6B7280","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["v3.1"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"v3.2"},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["v3.2"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["part_pay"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_partial_online_now"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Traveller pays part of the amount online and the remaining amount later."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_now"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Traveller pays the full amount online at the time of booking."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_local"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_at_pickup"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Traveller pays at the pickup location."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your integration maps, stores, filters, or displays ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_timings.id"]}," values, update your logic to use the v3.2 identifiers."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoints-with-no-significant-migration-changes","__idx":7},"children":["Endpoints with no significant migration changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some Cars endpoints do not require significant integration changes when migrating from v3.1 to v3.2."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"carsdepotsreviewsscores","__idx":8},"children":["/cars/depots/reviews/scores"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this endpoint to retrieve review scores and breakdowns for car rental depots."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No significant request or response changes require migration updates."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"carssuppliers","__idx":9},"children":["/cars/suppliers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this endpoint to retrieve car rental supplier information."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No significant request or response changes require migration updates."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"carsdetails","__idx":10},"children":["/cars/details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this endpoint to retrieve static vehicle information such as capacity, make, model, features, and specifications."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No significant request or response changes require migration updates."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Even where no migration action is required, validate the endpoints used by your integration against the v3.2 API reference before completing your migration."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"carsconstants-changes","__idx":11},"children":["/cars/constants changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["/cars/constants has been expanded in v3.2 with additional constant groups and updated values."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Key changes include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["New constant groups for car categories, customer services, depot types, extras, special offers, protection levels, and review scores."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Updated payment timing identifiers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Additional fuel policy, fuel type, and general constant values."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your integration stores or maps constants locally, refresh your mappings and ensure new values are handled without assuming a fixed closed set."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"extend-your-integration-with-beta-capabilities","__idx":12},"children":["Extend your integration with Beta capabilities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After migrating your existing v3.1 integration to stable v3.2, you can optionally extend it with car rental booking and selected post-booking capabilities available in Beta."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The capabilities in this section are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Beta"]}," and are not required to migrate an existing v3.1 Search, look and redirect integration to stable v3.2."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search-look-and-book","__idx":13},"children":["Search, look and book"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Beta supports the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/application-flows/search-look-book"},"children":["Search, look and book"]}," flow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A typical direct-booking flow uses:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["/cars/search to retrieve car rental offers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["/cars/availability to validate the selected offer and retrieve its latest pricing, policies, optional products, and insurance."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["/orders/preview to validate the selected order configuration and calculate its final pricing and payment schedule."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["/orders/create to create the order."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/cars-search-book-flow.dae8e56179e0dc549840a0205eab22426828aacb4b87bb0febe4816fdac1112f.8ae80680.png","alt":"Car rental Search, look and book flow"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"new-pre-booking-endpoints","__idx":14},"children":["New pre-booking 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":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Related guide"},"children":["Related guide"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/cars/availability"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate the selected offer and retrieve its latest pricing, policies, optional products, and insurance."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/3.2/check-cars-availability"},"children":["Check car availability guide"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/cars/terms-and-conditions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve the terms and conditions that apply to the selected car offer before booking."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/3.2/pre-booking-terms-and-cond"},"children":["Pre-booking terms and conditions guide"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"orders-integration","__idx":15},"children":["Orders integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cars can be booked through the Orders API collection in Beta."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["/orders/preview to validate the selected order configuration and retrieve final pricing, policies, and payment information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["/orders/create to create the car rental order."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The booking flow uses the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offer"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_token"]}," obtained from the preceding Cars flow."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/3.2/cars-tutorial"},"children":["Car rentals tutorial"]}," for an end-to-end implementation walkthrough."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"post-booking-capabilities","__idx":16},"children":["Post-booking capabilities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Selected post-booking functionality is also available in Beta."]},{"$$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":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/details/cars/live"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve the latest details for a car rental reservation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/cancel"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancel a supported car rental order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/details/cars/terms-and-conditions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve post-booking terms and conditions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/details/cars/faq"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve booking-related FAQs."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"test-your-migration","__idx":17},"children":["Test your migration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A dedicated sandbox environment is not currently available for car rental integrations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When validating your migration, follow the approved testing process for your integration and coordinate with your Account Manager where required."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure you validate:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Updated /cars/search request and response parsing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Renamed /cars/depots fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payment timing mappings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Static-data handling."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Redirect behaviour."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error handling."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Downstream systems that consume Cars data."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Beta booking and post-booking flows, if you implement them."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"migration-checklist","__idx":18},"children":["Migration checklist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this checklist before completing your v3.1-to-v3.2 migration."]},{"$$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":"Checklist"},"children":["Checklist"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review and implement the changes described in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/migration-guide/v3.2/cars/search"},"children":["/cars/search migration guide"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pick_up"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["drop_off"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropoff"]}," where applicable in /cars/depots."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove dependencies on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deskAt"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review and update mappings that depend on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_timings.id"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate the Cars endpoints used by your integration against the v3.2 schemas."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Test your migrated integration end to end."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Implement Beta booking and post-booking capabilities if required."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":19},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you use /cars/search, continue with the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/migration-guide/v3.2/cars/search"},"children":["/cars/search migration guide"]}," for detailed schema mappings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/overview"},"children":["Car rentals documentation"]}," for implementation guidance."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/cars"},"children":["Demand API v3.2 Cars API reference"]}," to validate your migrated integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you are implementing direct booking, review the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2-beta/demand-api"},"children":["Beta API reference"]}," and the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/3.2/cars-tutorial"},"children":["Car rentals tutorial"]},"."]}]}]},"headings":[{"value":"Migrate from v3.1 to Demand API v3.2","id":"migrate-from-v31-to-demand-api-v32","depth":1},{"value":"Migration overview","id":"migration-overview","depth":2},{"value":"Endpoint migration overview","id":"endpoint-migration-overview","depth":2},{"value":"Breaking changes","id":"breaking-changes","depth":2},{"value":"/cars/search","id":"carssearch","depth":3},{"value":"/cars/depots","id":"carsdepots","depth":3},{"value":"Payment timing identifiers","id":"payment-timing-identifiers","depth":2},{"value":"Endpoints with no significant migration changes","id":"endpoints-with-no-significant-migration-changes","depth":2},{"value":"/cars/depots/reviews/scores","id":"carsdepotsreviewsscores","depth":3},{"value":"/cars/suppliers","id":"carssuppliers","depth":3},{"value":"/cars/details","id":"carsdetails","depth":3},{"value":"/cars/constants changes","id":"carsconstants-changes","depth":2},{"value":"Extend your integration with Beta capabilities","id":"extend-your-integration-with-beta-capabilities","depth":2},{"value":"Search, look and book","id":"search-look-and-book","depth":3},{"value":"New pre-booking endpoints","id":"new-pre-booking-endpoints","depth":3},{"value":"Orders integration","id":"orders-integration","depth":3},{"value":"Post-booking capabilities","id":"post-booking-capabilities","depth":3},{"value":"Test your migration","id":"test-your-migration","depth":2},{"value":"Migration checklist","id":"migration-checklist","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Migrate your Car rentals integration","description":"Step-by-step guide to migrate your Car rentals integration from the Demand API version 3.1 to v3.2. Learn about architecture changes, endpoint differences, and migration checklist.","tags":["cars","car rentals","migration","demand api","integration"],"api":["/cars/search","/cars/availability","/cars/details","/cars/depots","/cars/suppliers"],"keywords":["car rental migration","cars API migration","demand API cars","search car rentals","book car rentals","car suppliers","car depots"],"x-redocly":{"seo":{"title":"Migrate Car Rentals integration – Demand API v3.2","description":"Detailed guide to migrate your Car rentals integration from the Demand API version 3.1 to v3.2. Learn about architecture changes, endpoint differences, and migration checklist."},"audience":["developer","partner","integrator"],"apiVersion":"v3.2, v3.2 Beta","product":["cars"]},"seo":{"title":"Migrate from v3.1 to Demand API v3.2"}},"lastModified":"2026-09-14T14:09:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/migration-guide/v3.2/cars/3.1-to-3.2","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}