{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["admonition","tabs","tab"]},"type":"markdown"},"seo":{"title":"Cancellation policies","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":"cancellation-policies","__idx":0},"children":["Cancellation policies"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["This guide outlines the cancellation policies supported by Demand API and includes examples of how to retrieve policy details using various endpoints during the pre-booking, booking and post-booking phases."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cancellation-types","__idx":1},"children":["Cancellation types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cancellation policies play a crucial role in the booking process, determining the terms under which a traveller can cancel their reservation and whether they are entitled to a refund or must pay a fee."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are three types of policies that are supported in Demand API with different level of flexibility:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/cancellationpolicies.329b7db045f4ce528009f1f653baa3d32268ba846850364ed45decb29d53ceb1.5e2a7131.png","alt":"cancellation-policies"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"flexible-policies---free-cancellation-until","__idx":2},"children":["Flexible policies - Free cancellation until"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This policy allows travellers to cancel their bookings without incurring fees within a specified time frame, usually:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["24-48 hours before checkin time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["7 days before arrival."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["By 12:00 PM on the day of arrival."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Properties can set how many days prior to the check in of the reservation the traveller can cancel for free."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is ideal for travellers seeking flexibility in their plans."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"special-conditions-policies-partially-refundable-in-v32-","__idx":3},"children":["Special conditions policies (Partially refundable in v3.2 )"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Bookings can be cancelled under this policy, but a cancellation fee will always apply."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Travellers will incur a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/cancellation-policies#cancellation-fees"},"children":["cancellation fee"]}," based on 50% of the total booking price or the cost of the first night stay."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Properties decide the terms of the partial fees and refunds."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/partially-refundable.4643edec0509d3bf1ba3afe687deca24a078b1aaf19902431b847ce4a27d420b.5e2a7131.png","alt":"partially-refund"},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can check the specific conditions and fees applied to products by reviewing the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/preview"},"children":["order/preview"]}," response."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note that ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/tpi/search-book-tpi-rates#cancel-a-tpi-booking#cancellation-restrictions"},"children":["Third-party inventory"]}," accommodations do not offer special conditions policies on their products as only flexible policies are available."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"non-refundable-policies","__idx":4},"children":["Non-refundable policies"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Under this policy, travellers must always pay the full amount of the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["total booking cost"]}," when cancelling their bookings, unless local laws specify otherwise."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The charge may happen at any time from the booking."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["This policy is typically associated with lower-priced, non-flexible rates."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/non-refundable.8721aeea074f2e3a684fcf55d98c823fbf02f177df528b8d7c1959b15ec46bd5.5e2a7131.png","alt":"non-refund"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cancellation-fees","__idx":5},"children":["Cancellation fees"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are 3 different fees that can be applied:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/policies.d2c4bf3e9ff1c0a05127cc4471b0da844b1da41a28063a6c14d7e4f19fb65d05.5e2a7131.png","alt":"policies"},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the cancellation fee calculation by looking at either the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/details"},"children":["orders/details"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/preview"},"children":["orders/preview"]}," endpoints responses."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Inform your travellers about the applicable fees during the booking process."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"important-considerations","__idx":6},"children":["Important considerations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✓ Do not forget to inform your travellers about the applicable policy when displaying your product page and during the booking process."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✓ Make sure you display the cancellation fee in line to local regulation. Example: Properties in Germany cannot charge 100% of total booking cost for cancellations by law."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cancellation-typesfees-in-demand-api","__idx":7},"children":["Cancellation types/fees in Demand API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Our Demand API provides detailed information about the cancellation policies, schedules and fees for each product block."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Multi-product policies"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cancellation policies are returned per-product rather than per-order. This allows you to easily manage complex multi-product (rooms, cars, etc) bookings where different policies apply to different selected products."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Similarly to what Booking.com offers in the website, each stage provides a different level of detail:"]},{"$$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":{"width":"30%","data-label":"Phase"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Phase"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Response"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pre-booking"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["/search"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["/availability"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return basic information about the cancellation policy type. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"If free cancellation applies, you can check until when.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note: At this stage applicable special conditions fees are not yet disclosed"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Booking"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["orders/preview endpoint"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve applied cancellation policy type together with schedules and applicable fees."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Post-booking"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["orders/details/* endpoints"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns the cancellation details per product (room or car selected) including the applicable type of policy together with schedules and fees."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Timezone and timestamp"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The default timezone in our Demand API is ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/Coordinated_Universal_Time","target":"_blank"},"children":["UTC (Coordinated Universal Time)"]}," and the timestamps follow the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank"},"children":["ISO 8601"]}," ","standard format."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pre-booking---search-and-availability","__idx":8},"children":["Pre-booking - Search and availability"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"accommodation-examples","__idx":9},"children":["Accommodation examples"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When searching for accommodations calling the accommodations/search and /availability endpoints, you can retrieve a simplified version of the cancellation policy."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"response-key-fields","__idx":10},"children":["Response key fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"Field"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.cancellation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Provides all the details of the cancellation policy assigned to the product."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_cancellation_until"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["In case there is free cancellation, you can also see the date and time up to when an order for the product can be cancelled for free. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," If there is no free cancellation and partially refundable or non-refundable policies apply, it returns “Null”."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancellation policy applicable to the product.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["One out of the 3 available options: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["non_refundable"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_cancellation"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partially_refundable"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["special_conditions"]}," in v3.1)."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Timezone and timestamp"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The default timezone in our Demand API is ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/Coordinated_Universal_Time","target":"_blank"},"children":["UTC (Coordinated Universal Time)"]}," and the timestamps follow the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank"},"children":["ISO 8601"]}," ","standard format."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-1---free-cancellation-until","__idx":11},"children":["Example 1 - Free cancellation until"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On this request, for this property there is a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/cancellation-policies#flexible-policies---free-cancellation-until"},"children":["flexible cancellation policy"]},", and travellers can cancel for free until 2025-10-06T21:59:59+00:00"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"v3.1 response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\n\"policies\": {\n  \"cancellation\": {\n    \"free_cancellation_until\": \"2025-10-06T21:59:59+00:00\",\n    \"schedule\": [\n      {\n        \"from\": \"now\",\n        \"price\": 0\n      },\n      {\n        \"from\": \"2025-10-06T22:00:00+00:00\",\n        \"price\": 4716.9\n      }\n    ],\n    \"type\": \"free_cancellation\"\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"v3.2 response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\n\"policies\": {\n  \"cancellation\": {\n    \"free_cancellation_until\": \"2025-10-06T21:59:59+00:00\",\n    \"schedule\": [\n      {\n        \"from\": \"now\",\n        \"price\": 0\n      },\n      {\n        \"from\": \"2025-10-06T22:00:00+00:00\",\n        \"price\": {\n            \"accommodation_currency\": 4716.9,\n            \"booker_currency\": 4716.9\n      }\n    ],\n    \"type\": \"free_cancellation\"\n  }\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-2---partially-refundable-special-conditions","__idx":12},"children":["Example 2 - Partially refundable (special conditions)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this case, the cancellation policy ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," is \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partially_refundable"]}," (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["special_conditions"]}," in v3.1) hence the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_cancellation_until"]}," field is marked as \"null\". This means there is no free cancellation and a fee may apply."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"products\": [\n  {\n    \"number_available_at_this_price\": 10,\n    \"policies\": {\n      \"cancellation\": {\n        \"free_cancellation_until\": null,\n        \"type\": \"special_conditions\"\n      },\n      \"meal_plan\": {\n        \"meals\": [],\n        \"plan\": \"no_plan\"\n      },\n      \"payment\": {\n        \"timings\": [\n          \"pay_at_the_property\",\n          \"pay_online_later\",\n          \"pay_online_now\"\n        ]\n      }\n    },\n    \"price\": {\n      \"book\": 204.00,\n      \"total\": 204.00\n    },\n    \"room\": 1050736002\n  }\n]\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At this stage fees are not yet disclosed for special conditions policies. Use the orders/preview endpoint to get further details on fees and schedules."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-3---non-refundable-policy","__idx":13},"children":["Example 3 - Non refundable policy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a product has a \"non_refundable\" type of policy, the \"free_cancellation_until\" field returns null, as this is not applicable."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"products\": [\n    {\n      \"id\": \"1000420_95127794_2_0_0\",\n      \"children\": [],\n      \"deal\": null,\n      \"number_of_adults\": 2,\n      \"policies\": {\n        \"cancellation\": {\n          \"free_cancellation_until\": null,\n          \"type\": \"non_refundable\"\n        },\n        \"meal_plan\": {\n          \"meals\": [],\n          \"plan\": \"no_plan\"\n        },\n        \"payment\": {\n          \"timings\": [\n            \"pay_at_the_property\"\n          ]\n        }\n      }\n    }\n  ]\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"car-rental-examples","__idx":14},"children":["Car rental examples"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When searching for cars calling the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/cars/search"},"children":["/search"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2-beta/demand-api/cars/availability"},"children":["/availability"]}," (Beta) endpoints, you can check a simplified version of the cancellation policy."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"response-key-fields-1","__idx":15},"children":["Response key fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are the fields included in the response:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"Field"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.cancellation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Provides all the details of the cancellation policy assigned to the product."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancellation policy applicable to the product. One out of the 2 available options: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["non_refundable"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_cancellation"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["context"]},"- The context in which the cancellation policy applies. For example 'before_pickup'"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["duration"]},"- The duration until which the cancellation is free. This is in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/code-conventions#durations"},"children":["ISO-8601/Duration format"]},"."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-1---free-cancellation","__idx":16},"children":["Example 1 - Free cancellation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On this request, for this car there is a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/cancellation-policies#flexible-policies---free-cancellation-until"},"children":["flexible cancellation policy"]},", and travellers ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["can cancel for free up to 48 hrs before pick up"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\n\"policies\": {\n      \"cancellation\": {\n        \"type\": \"free_cancellation\",\n        \"details\": {\n          \"context\": \"before_pickup\",\n          \"duration\": \"PT48H\"\n        }\n      },\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-2---no-refundable","__idx":17},"children":["Example 2 - No refundable"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For non_refundable cancellation policies:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"policies\": {\n      \"cancellation\": {\n        \"type\": \"non_refundable\",\n        \"details\": {\n          \"context\": \"null\",\n          \"duration\": \"null\"\n        }\n      },\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Car rentals do not support \"special conditions\" or \"partially_refundable\"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"booking---orderspreview","__idx":18},"children":["Booking - Orders/preview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To view the cancellation policy details and final fees for a specific product use the orders/preview endpoint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check either the:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.​accommodation.​products[].​policies.​cancellation"]}," - for accommodation product cancellation policies-related details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.car.policies.cancellation"]}," - for car cancellation policies-related details."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/order-preview-create#/orders/preview"},"children":["Create orders guide"]}," for examples."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"accommodation-examples-1","__idx":19},"children":["Accommodation examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"response-key-fields-2","__idx":20},"children":["Response key fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are the fields included in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.accommodation.products.policies.cancellation"]}," response:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"22%","data-label":"Field"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["From"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This parameter indicates the time from which the cancellation fee applies. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"  Using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["now"]}," means the policy is effective immediately at the time of booking."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This field discloses the fee that must be paid upon cancellation."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint provides a final review before the booking, so ensure that the cancellation policy details are clearly presented to travellers."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-1---free-cancellation-until-1","__idx":21},"children":["Example 1 - Free cancellation until"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"products\": [\n  {\n    \"id\": \"1000420_278556531_2_0_0\",\n    \"deal\": null,\n    \"policies\": {\n      \"cancellation\": [\n        {\n          \"from\": \"now\",\n          \"price\": {\n            \"accommodation_currency\": 0,\n            \"booker_currency\": null\n          }\n        },\n        {\n          \"from\": \"2025-12-08T23:00:00+00:00\",\n          \"price\": {\n            \"accommodation_currency\": 177.65,\n            \"booker_currency\": null\n          }\n        }\n      ]\n    }\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from.now"]}," - Indicates that from the moment of the booking, the traveller must pay the indicated price."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Here, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price.accommodation_currency"]}," is 0, reflecting a free cancellation policy."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from"]}," date specifies the deadline after which travellers will incur a cancellation fee (in this example 177.65)"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["This indicates that travellers can cancel for free until 2025-12-08T23:00:00+00:00."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After this point, the indicated cancellation fee applies."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-2---non-refundable","__idx":22},"children":["Example 2 - Non refundable"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following example the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from.now"]}," field indicates that from the moment of the booking, the traveller must pay the indicated fee for cancellations (170)."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"1000420_95127794_2_0_0\",\n  \"policies\": {\n    \"cancellation\": [\n      {\n        \"from\": \"now\",\n        \"price\": {\n          \"accommodation_currency\": 170,\n          \"booker_currency\": null\n        }\n      }\n    ]\n  },\n  \"price\": {\n    \"base\": {\n      \"accommodation_currency\": 162.98,\n      \"booker_currency\": null\n    },\n    \"extra_charges\": {\n      \"conditional\": [\n        {\n          \"charge\": 3,\n          \"condition\": 30,\n          \"mode\": \"per_stay\",\n          \"percentage\": null,\n          \"total_amount\": {\n            \"accommodation_currency\": 10,\n            \"booker_currency\": null\n          },\n          \"unit_amount\": null\n        }\n      ]\n    },\n    \"total\": {\n      \"accommodation_currency\": 195.06,\n      \"booker_currency\": null\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"post-booking-ordersdetails","__idx":23},"children":["Post-booking: Orders/details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The orders/details/* endpoints present in their responses whether an order has been cancelled in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," field and also under which terms (in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancellation_details"]}," field, including the cancellation ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fee"]}," that was charged, and when it was charged."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"accommodation-examples-2","__idx":24},"children":["Accommodation examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example---free-cancellation-until","__idx":25},"children":["Example - Free cancellation until"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancellation_details"]}," field is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," because the order has not yet been cancelled, and the checkin is on the \"2026-08-24\"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"accommodation_order_references\": [],\n  \"cancellation_details\": null,\n  \"checkin\": \"2026-08-24\",\n  \"checkout\": \"2026-08-26\",\n  \"commission\": {...},\n  \"products\": [\n    \"policies\": {\n    \"cancellation\": [\n      {\n        \"from\": \"2026-08-22T14:22:43+00:00\",\n        \"price\": {\n          \"accommodation_currency\": 45.00,\n          \"booker_currency\": 38.35\n        }\n      }\n    ]\n  },\n  \"status\": \"booked\"\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The cancellation is free until 2 days before the checkin date."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["From 2026-08-22 (UCT time) the traveller will be charged the stated amount (38.35)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-of-cancelled-order-with-fee","__idx":26},"children":["Example of cancelled order with fee"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, there is a fee applied to the cancellation."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01fr9ez700exycb98w90w5r9sh\",\n  \"data\": [\n    {\n      \"id\": \"509430129718799\",\n      \"reservation\": \"12345678\",\n      \"status\": \"cancelled\",\n      \"checkin\": \"2025-12-10\",\n      \"checkout\": \"2025-12-18\",\n      \"cancellation_details\": {\n        \"at\": \"2025-12-09T00:00:00+00:00\",\n        \"fee\": {\n          \"accommodation_currency\": 170.01,\n          \"booker_currency\": 186.87\n        },\n        \"original_total_price\": {\n          \"accommodation_currency\": 170.01,\n          \"booker_currency\": 186.87\n        }\n      }\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"car-rental-examples-1","__idx":27},"children":["Car rental examples"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2-beta/demand-api/orders/details/cars/live"},"children":["orders/details/cars/live"]}," in Beta version (future orders/details/cars in v3.3)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"cancellation\": {\n    \"type\": \"free_cancellation\",\n    \"schedule\": [\n      {\n        \"from\": \"2025-10-14T10:00:00Z\",\n        \"to\": \"2025-10-17T09:59:59Z\",\n        \"free_cancellation\": true,\n        \"price\": null\n      },\n      {\n        \"from\": \"2025-10-17T10:00:00Z\",\n        \"to\": \"2025-10-19T10:00:00Z\",\n        \"free_cancellation\": false,\n        \"price\": {\n          \"display\": {\n            \"value\": 25.00,\n            \"currency\": \"USD\"\n          },\n          \"pay\": {\n            \"value\": 22.73,\n            \"currency\": \"EUR\",\n            \"timing\": \"pay_online_now\"\n          }\n        }\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key parameters:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_cancellation"]}," → boolean indicating whether any free cancellation window exists."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["schedule"]}," → chronological array of cancellation windows."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each window contains:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from"]}," → start datetime for that fee."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}," → object with booker_currency and supplier_currency."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":28},"children":["Best practices"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When handling cancellation policies in your application:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Clearly display cancellation terms to users during the booking process."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When proceeding an order, it is crucial to emphasise the cancellation deadlines and fees within your application."]}]},{"$$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":["For a better understanding of the cancellation process, check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/cancel-order"},"children":["Handling cancellations"]}," guide."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/overview"},"children":["Orders section"]}," for instructions on how to use the orders/details and orders/preview endpoints."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can also check the workflow for pre-booking and booking phases in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/getting-started/try-out-the-api"},"children":["Try out full guide"]},"."]}]}]}]},"headings":[{"value":"Cancellation policies","id":"cancellation-policies","depth":1},{"value":"Cancellation types","id":"cancellation-types","depth":2},{"value":"Flexible policies - Free cancellation until","id":"flexible-policies---free-cancellation-until","depth":3},{"value":"Special conditions policies (Partially refundable in v3.2 )","id":"special-conditions-policies-partially-refundable-in-v32-","depth":3},{"value":"Non-refundable policies","id":"non-refundable-policies","depth":3},{"value":"Cancellation fees","id":"cancellation-fees","depth":2},{"value":"Important considerations","id":"important-considerations","depth":3},{"value":"Cancellation types/fees in Demand API","id":"cancellation-typesfees-in-demand-api","depth":2},{"value":"Pre-booking - Search and availability","id":"pre-booking---search-and-availability","depth":2},{"value":"Accommodation examples","id":"accommodation-examples","depth":3},{"value":"Response key fields","id":"response-key-fields","depth":4},{"value":"Example 1 - Free cancellation until","id":"example-1---free-cancellation-until","depth":4},{"value":"Example 2 - Partially refundable (special conditions)","id":"example-2---partially-refundable-special-conditions","depth":4},{"value":"Example 3 - Non refundable policy","id":"example-3---non-refundable-policy","depth":4},{"value":"Car rental examples","id":"car-rental-examples","depth":3},{"value":"Response key fields","id":"response-key-fields-1","depth":4},{"value":"Example 1 - Free cancellation","id":"example-1---free-cancellation","depth":4},{"value":"Example 2 - No refundable","id":"example-2---no-refundable","depth":4},{"value":"Booking - Orders/preview","id":"booking---orderspreview","depth":2},{"value":"Accommodation examples","id":"accommodation-examples-1","depth":3},{"value":"Response key fields","id":"response-key-fields-2","depth":4},{"value":"Example 1 - Free cancellation until","id":"example-1---free-cancellation-until-1","depth":4},{"value":"Example 2 - Non refundable","id":"example-2---non-refundable","depth":4},{"value":"Post-booking: Orders/details","id":"post-booking-ordersdetails","depth":2},{"value":"Accommodation examples","id":"accommodation-examples-2","depth":3},{"value":"Example - Free cancellation until","id":"example---free-cancellation-until","depth":4},{"value":"Example of cancelled order with fee","id":"example-of-cancelled-order-with-fee","depth":4},{"value":"Car rental examples","id":"car-rental-examples-1","depth":3},{"value":"Best practices","id":"best-practices","depth":2}],"frontmatter":{"seo":{"title":"Cancellation policies"}},"lastModified":"2026-07-27T14:43:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/orders-api/cancellation-policies-3.1","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}