{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Preview order modifications 3.2 Beta","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":"preview-order-modifications","__idx":0},"children":["Preview order modifications ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#fbbf24","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.2 Beta"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learn how to use the /orders/modify/preview endpoint to check and validate changes in accommodation orders. This guide outlines required parameters, and practical examples to validate accommodation dates, room details or payment modifications."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the /orders/modify/preview endpoint to check whether a requested modification can be applied to an order and review its impact before confirming the change."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint does not apply any changes."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-to-use-this-endpoint","__idx":2},"children":["When to use this endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the preview endpoint to:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Validate whether a modification is allowed before attempting it. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✅ Avoid failed modification requests. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✅ Show users the expected cost impact (for accommodation date changes) ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-it-fits-in-the-flow","__idx":3},"children":["How it fits in the flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this endpoint as an optional step before modifying an order:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call /orders/modify/preview."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modifiable"]}," field in the response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If true, proceed with /orders/modify."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Preview → Validate → Modify"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-modification-types","__idx":4},"children":["Supported modification types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The endpoint supports previewing 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":"Modification type"},"children":["Modification type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field to include in modification object"},"children":["Field to include in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modification"]}," object"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type: card"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accommodation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check-in and check-out dates"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type: dates"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accommodation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Room-level details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["(guest allocation, guest names, smoking preferences)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type: room"]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint-usage","__idx":5},"children":["Endpoint usage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When making a request to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/3.2-beta/demand-api/orders/orders/modify/preview"},"children":["orders/modify/preview endpoint"]},", you must include:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-structure","__idx":6},"children":["Request structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request body always includes:"]},{"$$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":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"120px"}},"children":["Parameter"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"120px"}},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The order ID (string) of the booking to modify."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Object containing the modification details, either:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]}," - For card updates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accommodation"]}," - For dates or room updates."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"preview-card-details-modifications","__idx":7},"children":["Preview card details modifications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To check whether modifications in the payment card is possible:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modification.payment"]}," object."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"change\""]}," object with:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]},": The new credit card number."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvc"]},": The card’s CVC code (3–4 digits)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardholder"]},": The cardholder's name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expiry_date"]},": The card's expiry date in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["YYYY-MM format"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request---card-modification","__idx":8},"children":["Example request - Card modification"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"order\": \"6520081014\",\n  \"modification\": {\n    \"payment\": {\n      \"type\": \"card\",\n      \"change\": {\n        \"cardholder\": \"John Doe\",\n        \"number\": \"4111111111111111\",\n        \"expiry_date\": \"2027-12\",\n        \"cvc\": \"123\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/models/booking-collects#2-create-your-order"},"children":["Credit card payments"]}," section for best practices when using cards as payment method."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"preview-accommodation-date-change","__idx":9},"children":["Preview accommodation date change"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To check whether an accommodation date modification is possible:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modification.accommodation"]}," object to modify the dates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservation"]}," ID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"dates\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include the new dates in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["change"]}," (checkin and checkout) using ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["YYYY-MM-DD format"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Modifying dates may change the total price. Check the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["new"]}," price in the response."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request---dates-modification","__idx":10},"children":["Example request - Dates modification"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"order\": \"4297204980\",\n  \"modification\": {\n    \"accommodation\": {\n      \"reservation\": \"4297204980\",\n      \"type\": \"dates\",\n      \"change\": {\n        \"checkin\": \"2026-10-20\",\n        \"checkout\": \"2026-10-21\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"preview-accommodation-room-change","__idx":11},"children":["Preview accommodation room change"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To check whether it is possible to update room-level details such as guest names, allocation, or smoking preferences:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modification.accommodation"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["room"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservation"]}," ID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["change"]}," object, specify:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["room_reservation"]}," ID (string)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guests[].name"]}," - Update the guest name(s)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allocation.number_of_adults"]}," - Update number of adults."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smoking_preference"]}," - Modify the smoking preference for the room (\"smoking\", \"non_smoking\", or \"no_preference\")."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/details/accommodations"},"children":["/orders/details/accommodations endpoint"]}," to retrieve the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["room_reservation"]}," IDs located under \"products\" in each object. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["room_reservation"]}," ID is required for all room-level modifications."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request---room-modification","__idx":12},"children":["Example request - Room modification"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"order\": \"5000375899\",\n  \"modification\": {\n    \"accommodation\": {\n      \"reservation\": \"5000375899\",\n      \"type\": \"room\",\n      \"change\": {\n        \"room_reservation\": \"5448643068\",\n        \"allocation\": {\n          \"number_of_adults\": 2\n        },\n        \"guests\": [\n          { \"name\": \"Test Test\" },\n          { \"name\": \"Test2 Test\" }\n        ],\n        \"smoking_preference\": \"smoking\"\n      }\n    }\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understanding-the-response","__idx":13},"children":["Understanding the response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All responses include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," – Unique identifier for the request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.modifiable"]}," – Indicates whether the modification can be applied."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-modifiable-is-false","__idx":14},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modifiable"]}," is false"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"data\": {\n    \"modifiable\": false,\n    \"reason\": \"Modification not allowed for this reservation since this order has been cancelled.\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The modification cannot be applied."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The reason field explains why."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-modifiable-is-true","__idx":15},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modifiable"]}," is true"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"data\": {\n    \"modifiable\": true\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The modification can be applied."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can proceed with /orders/modify"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"price-information-accommodation-date-changes-only","__idx":16},"children":["Price information (accommodation date changes only)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For date changes, the response includes updated pricing:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"data\": {\n    \"modifiable\": true,\n    \"price\": {\n      \"currency\": \"EUR\",\n      \"current\": {\n        \"amount\": 200.00\n      },\n      \"new\": {\n        \"amount\": 250.00\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Show users the updated total cost."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Highlight any price difference before confirmation."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}," is only included for accommodation date modifications."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"handling-the-response","__idx":17},"children":["Handling the response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modifiable = false"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not call /orders/modify endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reason"]}," to the user."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modifiable = true"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Proceed with /orders/modify endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally display updated pricing (if available)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"limitations","__idx":18},"children":["Limitations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Price information is only returned for accommodation date changes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Not all modification scenarios may be supported."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Behaviour and response fields may change as this endpoint is in Beta."]}]},{"$$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":["Refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/orders-api/order-modify"},"children":["orders/modify guide"]}," to learn how to proceed the modifications."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find likely errors in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":["Error handling guide"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/orders-api/cancel-order"},"children":["Cancellations guide"]}," in case you need to cancel the order instead."]}]}]}]},"headings":[{"value":"Preview order modifications","id":"preview-order-modifications","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"When to use this endpoint","id":"when-to-use-this-endpoint","depth":3},{"value":"How it fits in the flow","id":"how-it-fits-in-the-flow","depth":3},{"value":"Supported modification types","id":"supported-modification-types","depth":2},{"value":"Endpoint usage","id":"endpoint-usage","depth":2},{"value":"Request structure","id":"request-structure","depth":3},{"value":"Preview card details modifications","id":"preview-card-details-modifications","depth":2},{"value":"Example request - Card modification","id":"example-request---card-modification","depth":3},{"value":"Preview accommodation date change","id":"preview-accommodation-date-change","depth":2},{"value":"Example request - Dates modification","id":"example-request---dates-modification","depth":3},{"value":"Preview accommodation room change","id":"preview-accommodation-room-change","depth":2},{"value":"Example request - Room modification","id":"example-request---room-modification","depth":3},{"value":"Understanding the response","id":"understanding-the-response","depth":2},{"value":"When modifiable is false","id":"when-modifiable-is-false","depth":3},{"value":"When modifiable is true","id":"when-modifiable-is-true","depth":3},{"value":"Price information (accommodation date changes only)","id":"price-information-accommodation-date-changes-only","depth":3},{"value":"Handling the response","id":"handling-the-response","depth":3},{"value":"Limitations","id":"limitations","depth":2}],"frontmatter":{"title":"Preview order modifications","description":"Learn how to validate changes in accommodation orders using the /orders/modify/preview endpoint, including payment, stay dates, and room-level modifications before applying them.","tags":["demand-api","orders","order-modification","payments","accommodation","reservations","room-details"],"api":["/orders/modify/preview","/orders/modify","/orders/details","/orders/details/accommodations"],"keywords":["preview order Booking.com","orders modify preview endpoint","validate reservation changes API","payment modification preview","room-level modification preview","accommodation order validation"],"x-redocly":{"seo":{"title":"Preview accommodation order modifications with the Demand API","description":"Guide to previewing changes in accommodation orders using Booking.com's Demand API, including card updates, date changes, and room-level modifications before confirmation."}},"audience":["developer","partners"],"apiVersion":"3.2 Beta","product":"accommodation","seo":{"title":"Preview order modifications 3.2 Beta"}},"lastModified":"2026-05-21T14:07:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/orders-api/3.2/order-modify-preview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}