{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","cards"]},"type":"markdown"},"seo":{"title":"Demand API v3.3 migration overview","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"demand-api-v33-migration-overview","__idx":0},"children":["Demand API v3.3 migration overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Understand the main changes introduced in Demand API v3.3, identify changes that may affect your integration, and find the relevant migration guide."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"whats-changing-in-v33","__idx":1},"children":["What's changing in v3.3"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Demand API v3.3 is the latest stable version of the API."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It introduces new capabilities, extends existing travel-service integrations, and includes features that were previously available in 3.2 Beta."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The release also introduces a generic Beta version for capabilities that remain under active development. Beta capabilities may change before they become part of a stable API version, including changes to endpoints, schemas, fields, and supported integration flows."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following summary shows the release status of the main capabilities in v3.3. See the availability table below for a comparison across v3.2 Stable, v3.3 Stable, and the generic Beta version."]},{"$$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":"Capability"},"children":["Capability"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"v3.3 status"},"children":["v3.3 status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Release context"},"children":["Release context"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accommodation sustainability metadata and seasonal deal tagging"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New in v3.3"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Real-time autocomplete for guided accommodation search flows"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Promoted from 3.2 Beta"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Car Search, look and book, insurance, and post-booking capabilities"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Promoted from 3.2 Beta; also available in v3.2 Stable"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Car invoicing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New in v3.3"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Attractions content, search, and metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Promoted from 3.2 Beta; also available in v3.2 Stable"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Points of interest support for Attractions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New in v3.3"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accommodation order modifications for online payments"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New in v3.3"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order modification preview"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Promoted from 3.2 Beta"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AI Smart Search"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Beta"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remains in Beta while under development"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transfers search"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Beta"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available only in the generic Beta version"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-availability-after-the-v33-launch","__idx":2},"children":["API availability after the v3.3 launch"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table shows the availability of selected key capabilities across the stable API versions and the generic Beta version after the v3.3 launch."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Some capabilities that were previously available in 3.2 Beta and have been promoted to stable are available through the stable API versions shown in the table."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Capabilities that remain under active development are available through the generic Beta version."]}]}]},{"$$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":"Capability"},"children":["Capability"]},{"$$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":"v3.3"},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#003B95","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["v3.3"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Beta"},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#fbbf24","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["Beta"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Attractions content and Search, look and redirect — attractions/search and attractions/details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cars Search, look and book — cars/availability and car support in orders/preview and orders/create"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Car insurance"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cars post-booking — terms and conditions and FAQs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Car invoicing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transfers content and Search and redirect — transfers/search"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Orders modification preview"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Real-time autocomplete — /common/autocomplete"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accommodation Smart Search"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the dedicated migration guide for each travel service to review the endpoint, schema, field, and enum changes that apply to your integration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"changes-that-may-require-action","__idx":3},"children":["Changes that may require action"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some v3.3 changes may require updates to your integration. Review the dedicated migration guide for each travel service you use."]},{"$$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":"Travel service"},"children":["Travel service"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Changes to review"},"children":["Changes to review"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Detailed guidance"},"children":["Detailed guidance"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accommodation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review new and changed fields, endpoint schemas, autocomplete, sustainability metadata, and seasonal deal tagging."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/migration-guide/v3.3/accommodations/intro"},"children":["Accommodation migration guide"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Car rentals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review the booking flow, insurance, payment terminology, invoicing, post-booking capabilities, and the replacement of /orders/details/cars/live with /orders/details/cars."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/migration-guide/v3.3/cars/intro"},"children":["Car rental migration guide"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Attractions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review the stable availability of Attractions capabilities, metadata updates, and points of interest support."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/attractions/about-attractions"},"children":["Attractions guidelines"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Orders"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review modifications for online-paid accommodation orders, orders/modify/preview, and related request and response changes."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/migration-guide/v3.3/orders/intro"},"children":["Orders migration guide"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choose-your-migration-guide","__idx":4},"children":["Choose your migration guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose the travel service or API collection you want to migrate. Each guide provides detailed migration instructions for the relevant endpoints and schemas."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"cards":[{"title":"Accommodation integration — v3.3","description":"Migrate your accommodation integration to v3.3, including changes to endpoints, structures, and integration flows.","icon":"bed","link":"/demand/docs/migration-guide/v3.3/accommodations/intro","withArrow":true},{"title":"Car rental integration — v3.3","description":"Migrate your car rental integration to v3.3, including changes to search, booking, post-booking, pricing, and invoicing.","icon":"car","link":"/demand/docs/migration-guide/v3.3/cars/intro","withArrow":true},{"title":"Orders integration — v3.3","description":"Migrate your Orders integration to v3.3, including changes to endpoints, request and response structures, and integration flows.","icon":"notepad","link":"/demand/docs/migration-guide/v3.3/orders/intro","withArrow":true}]},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"v33-stable-version","__idx":5},"children":["v3.3 Stable version"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"accommodation","__idx":6},"children":["Accommodation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["v3.3 improves accommodation discovery and the way partners can present sustainability information to travellers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The main accommodation changes are:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"sustainability-certification-metadata","__idx":7},"children":["Sustainability certification metadata"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sustainability certification metadata"]}," — The accommodations/details endpoint now includes sustainability programme data without additional access requirements, including third-party certification details and certification logo metadata."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Real-time autocomplete"]}," — /common/autocomplete supports low-latency, as-you-type destination suggestions with typo tolerance. Partners can use it to support guided search flows and help travellers reach a valid search criterion more quickly."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Seasonal deal tagging"]}," — accommodation responses expose explicit deal tags for seasonal deals, allowing partners to display relevant promotional messaging consistently."]}]},{"$$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.3/accommodations/intro"},"children":["Accommodation migration guide"]}," for the changes you need to make to your integration."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"car-rentals","__idx":8},"children":["Car rentals"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Car Rentals API supports a complete Search, look and book experience in both v3.2 Stable and v3.3. Partners migrating to v3.3 should review the endpoint and schema changes rather than treating the complete booking flow as exclusive to v3.3."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The main car rental changes are:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Search, look and book"]}," — partners can search for offers, validate availability, review terms and payment requirements, preview orders, and create car orders."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insurance booking"]}," — eligible insurance options can be selected and booked through the Demand API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Car invoicing"]}," — eligible car reservations can provide invoice documents and their current status. This capability is available only in v3.3 Stable."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Post-booking information"]}," — partners can retrieve terms and conditions, FAQs, live reservation details, supplier confirmation information, pickup instructions, and insurance documents where available."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint update"]}," — use /orders/details/cars for live car reservation details in v3.3. In v3.2, continue to use /orders/details/cars/live."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Terminology and payment updates"]}," — review payment-related enum and field changes, including updates to payment timing values such as pay_partially_online."]}]},{"$$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.3/cars/intro"},"children":["Car rental migration guide"]}," for implementation details."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"attractions","__idx":9},"children":["Attractions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Attractions content and Search, look and redirect capabilities that were previously available in 3.2 Beta are now available in both 3.2 Stable and 3.3 Stable."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The main Attractions changes are:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Attractions content and search"]}," — retrieve attraction information, search for attractions, present search results, and redirect travellers to Booking.com to complete a reservation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Attractions metadata"]}," — attractions/constants provides static category and subcategory metadata that partners can cache and use for category-based filtering and navigation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Points of interest"]}," — v3.3 introduces points of interest support for more precise attraction discovery around landmarks, venues, neighbourhoods, and other traveller-interest locations."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"orders","__idx":10},"children":["Orders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["v3.3 introduces accommodation order modifications, allowing eligible changes to be validated and applied without relying exclusively on a cancel-and-rebook workflow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The main Orders changes are:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accommodation order modifications"]}," — eligible prepaid accommodation orders can support changes to dates, room-level details, and payment-related information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order modification preview"]}," — orders/modify/preview allows partners to check whether a requested modification can be applied and review its expected price impact before submitting it through orders/modify."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Traveller confirmation"]}," — partners can use the preview response to present the proposed change and its price impact before applying the modification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Consultative preview"]}," — orders/modify/preview validates the requested change but does not apply it."]}]},{"$$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.3/orders/intro"},"children":["Orders migration guide"]}," for endpoint-specific changes."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"generic-beta-version","__idx":11},"children":["Generic Beta version"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The generic Beta version contains capabilities that remain under active development. These capabilities may change before becoming part of a stable API version."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check the relevant Beta documentation and confirm that your account has access before implementing a Beta capability."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ai-smart-search","__idx":12},"children":["AI Smart Search"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The /accommodations/smart-search endpoint supports intent-based accommodation discovery from flexible or conversational search input."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It can help partners build more natural search experiences by allowing travellers to express broader preferences instead of selecting every search criterion separately."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AI Smart Search remains in the generic Beta version while its search behaviour, supported scenarios, and response experience continue to be refined."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"transfers-search","__idx":13},"children":["Transfers search"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The /transfers/search endpoint supports a Search and redirect flow for transfers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Partners can use it to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submit a transfer journey."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve resolved route information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display available transfer options, prices, and cancellation policies."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Redirect the traveller to Booking.com to complete the reservation."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transfers search is available only in the generic Beta version and is not included in 3.2 Stable or 3.3 Stable."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/beta/demand-api/transfers/searchtransfers"},"children":["Transfers API reference"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/transfers/about-transfers"},"children":["Transfers guides"]}," for details."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"additional-services","__idx":14},"children":["Additional services"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"messaging","__idx":15},"children":["Messaging"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Messaging is documented as an additional service separate from the main Demand API collection."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It provides a secure, two-way communication bridge between partners and properties for stay-related conversations, including:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check-in arrangements."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Key collection."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Special requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Other accommodation logistics."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Messaging has its own lifecycle and is compatible with Demand API versions 3.1, 3.2, and 3.3. Its release status should therefore be understood independently from the Demand API version."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/messaging/about-messaging"},"children":["Messaging documentation"]}," for details."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"status-api-dashboard","__idx":16},"children":["Status API Dashboard"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Status API now includes a Dashboard linked to the Developers portal. Partners can use it to monitor the availability of Demand API endpoints and service groups through a visual interface."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/additional-services/status-api/about"},"children":["Status API documentation"]}," for more information."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-migrate","__idx":17},"children":["Before you migrate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before updating your integration:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Identify the Demand API version and Beta capabilities currently used by your application."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review the dedicated migration guide for each travel service or API collection you use."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check whether any capability has moved from 3.2 Beta to a stable version."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review endpoint, schema, field, and enum changes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update your data models and application flows."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Test requests, responses, error handling, and downstream processing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm that your account has access to any capability that remains in the generic Beta version."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A dedicated sandbox environment is currently not available for car rental integrations."]}]}]},"headings":[{"value":"Demand API v3.3 migration overview","id":"demand-api-v33-migration-overview","depth":1},{"value":"What's changing in v3.3","id":"whats-changing-in-v33","depth":2},{"value":"API availability after the v3.3 launch","id":"api-availability-after-the-v33-launch","depth":2},{"value":"Changes that may require action","id":"changes-that-may-require-action","depth":2},{"value":"Choose your migration guide","id":"choose-your-migration-guide","depth":2},{"value":"v3.3 Stable version","id":"v33-stable-version","depth":2},{"value":"Accommodation","id":"accommodation","depth":3},{"value":"Sustainability certification metadata","id":"sustainability-certification-metadata","depth":4},{"value":"Car rentals","id":"car-rentals","depth":3},{"value":"Attractions","id":"attractions","depth":3},{"value":"Orders","id":"orders","depth":3},{"value":"Generic Beta version","id":"generic-beta-version","depth":2},{"value":"AI Smart Search","id":"ai-smart-search","depth":3},{"value":"Transfers search","id":"transfers-search","depth":3},{"value":"Additional services","id":"additional-services","depth":2},{"value":"Messaging","id":"messaging","depth":3},{"value":"Status API Dashboard","id":"status-api-dashboard","depth":3},{"value":"Before you migrate","id":"before-you-migrate","depth":2}],"frontmatter":{"cards":{"productsAndFeatures":[{"title":"Accommodation integration — v3.3","description":"Migrate your accommodation integration to v3.3, including changes to endpoints, structures, and integration flows.","icon":"bed","link":"/demand/docs/migration-guide/v3.3/accommodations/intro","withArrow":true},{"title":"Car rental integration — v3.3","description":"Migrate your car rental integration to v3.3, including changes to search, booking, post-booking, pricing, and invoicing.","icon":"car","link":"/demand/docs/migration-guide/v3.3/cars/intro","withArrow":true},{"title":"Orders integration — v3.3","description":"Migrate your Orders integration to v3.3, including changes to endpoints, request and response structures, and integration flows.","icon":"notepad","link":"/demand/docs/migration-guide/v3.3/orders/intro","withArrow":true}]},"seo":{"title":"Demand API v3.3 migration overview"}},"lastModified":"2026-10-17T11:51:31.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/migration-guide/v3.3/changes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}