{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Retrieve deals, target and CUG rates","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"retrieve-deals-target-and-cug-rates","__idx":0},"children":["Retrieve deals, target and CUG rates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learn how to provide traveller context to retrieve eligible accommodation deals and rates, and how to interpret the discount information in the response."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["v3.2"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#003B95","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["v3.3"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The deals and rates returned by the Demand API can depend on the traveller’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform"]},", stay dates, authentication status and your partner configuration."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact your Account Manager to confirm which rate types and discount programmes your integration can access."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide covers:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deals"]}," — Promotional discounts that may be tied to a campaign or time period."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Target rates"]}," — Rates for eligible travellers, for example based on their ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform"]}," or location."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Closed user group (CUG) rates"]}," — Rates available to eligible travellers in a defined user group."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request examples use the v3.3 request and response structure. For v3.2 integrations, use the version-specific API reference and deal-tag values. Bundles and inventory rates are covered in their own guides."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/display-discounts"},"children":["Displaying discounts"]}," for guidance on presenting discount information to travellers."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-rates-and-discounts-are-retrieved","__idx":1},"children":["How rates and discounts are retrieved"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the accommodation search and availability flow to retrieve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}," for the requested stay and traveller context."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call /accommodations/search with the traveller’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker"]}," context, stay dates and guest details. Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}," in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extras"]}," field to receive product information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call /accommodations/availability with the selected accommodation and the same applicable traveller context to retrieve current availability, prices and product details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Before creating an order, call /orders/preview with the selected product and applicable accommodation details to validate the order and review its current price and terms."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API returns rates and discounts for which the traveller is eligible and your partner account is configured. Providing a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}," or user group does not guarantee a particular rate or discount."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"provide-the-traveller-context","__idx":2},"children":["Provide the traveller context"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker"]}," object describes the traveller context used to determine applicable prices and rates."]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"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":["country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker"]},"’s country. This is used to return the best price for the user and to support applicable tax and fee display requirements."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker"]},"’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform"]},", such as android, desktop, ios, mobile or tablet. This is used for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform"]},"-based deals and prices."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker"]},"’s state. Currently applicable only when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}," is US."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_groups"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User groups that apply to the booker, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authenticated"]}," and eligible membership tiers."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Use accurate and consistent context"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide the traveller’s actual ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state"]}," where applicable and authentication status. Keep the applicable context consistent across search, availability and order preview. Changing it can change the rates returned."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkin"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout"]}," dates are top-level request fields; they are not part of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker"]}," object."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Stay dates can affect eligibility for time-sensitive discounts."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cug-rates-and-authentication","__idx":3},"children":["CUG rates and authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To request rates for an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authenticated"]}," traveller, include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authenticated"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker.user_groups"]},". Only include this value when the traveller is authenticated."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not send membership-tier values such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["genius"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["genius2"]}," unless the schema and your partner-specific integration guidance explicitly support them."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Whether an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authenticated"]}," traveller receives a particular CUG rate depends on their eligibility and your partner configuration."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"booker\": {\n    \"country\": \"us\",\n    \"platform\": \"desktop\",\n    \"user_groups\": [\n      \"authenticated\",\n      \"genius2\"\n    ]\n  },\n  \"checkin\": \"2026-12-05\",\n  \"checkout\": \"2026-12-14\",\n  \"city\": -2140479,\n  \"extras\": [\n    \"products\"\n  ],\n  \"guests\": {\n    \"number_of_adults\": 2,\n    \"number_of_rooms\": 1\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"User-group eligibility"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only provide user groups that apply to the traveller and are supported by your partner configuration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Providing a user group does not by itself make a traveller eligible for that rate."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search-for-target-rates","__idx":4},"children":["Search for target rates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following v3.3 request supplies a mobile ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform"]}," and United States ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}," context. It also includes the stay dates and guest details required for an accommodation search."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"booker\": {\n    \"country\": \"us\",\n    \"platform\": \"mobile\"\n  },\n  \"checkin\": \"2026-12-05\",\n  \"checkout\": \"2026-12-14\",\n  \"city\": -2140479,\n  \"extras\": [\n    \"products\"\n  ],\n  \"guests\": {\n    \"number_of_adults\": 2,\n    \"number_of_rooms\": 1\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the traveller’s actual ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform"]},". Use the common/locations/countries endpoint to retrieve supported ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}," codes."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/search-for-available-properties"},"children":["Search for available properties guide"]}," for more information about building accommodation search requests."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understand-discounts-in-responses","__idx":5},"children":["Understand discounts in responses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a product has discount information, its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deal"]}," field can contain a discount percentage, the original price before discounts and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tags"]}," describing the applied deals. The field can be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deal"]}," information applies."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Monetary values are returned as objects with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accommodation_currency"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker_currency"]}," amounts. The traveller-facing display amount is returned in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price.display"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The example below assumes there are no additional charges, so the display amount matches the discounted amount."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example---search-response-with-discounts","__idx":6},"children":["Example - Search response with discounts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example shows an accommodation product with a 28% total discount."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["public_price"]}," is 100.00, and its resulting ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price.display"]}," is 72.00. The returned tags indicate that the product includes a mobile rate and a limited-time deal."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01fr9ez700exycb98w90w5r9sh\",\n  \"data\": [\n    {\n      \"id\": 10004,\n      \"products\": [\n        {\n          \"id\": \"1000420_95127794_2_0_0\",\n          \"deal\": {\n            \"discount_percentage\": 28,\n            \"public_price\": {\n              \"accommodation_currency\": 100.00,\n              \"booker_currency\": 100.00\n            },\n            \"tags\": [\n              \"mobile_rate\",\n              \"limited_time_deal\"\n            ]\n          },\n          \"price\": {\n            \"display\": {\n              \"accommodation_currency\": 72.00,\n              \"booker_currency\": 72.00\n            },\n            \"total\": {\n              \"accommodation_currency\": 72.00,\n              \"booker_currency\": 72.00\n            }\n          }\n        }\n      ]\n    }\n  ]\n}\n\n","lang":"json"},"children":[]},{"$$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":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"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":["deal.discount_percentage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The total discount percentage represented for the applied deals."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deal.public_price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The original product price before discounts. It contains accommodation-currency and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker"]},"-currency amounts."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deal.tags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tags describing characteristics of the applied deals. They do not expose the underlying promotion rules or a price breakdown."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price.display"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The display price for the traveller. It contains accommodation-currency and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker"]},"-currency amounts."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price.total"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The total price, including extra charges. Use the applicable pricing guidance when presenting prices."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The discount information is a summary. It might not include a breakdown of each discount used to calculate the total discount percentage. Use the price fields returned by the API; do not derive the final price from the tags."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"deal-tags","__idx":7},"children":["Deal tags"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deal.tags"]}," array identifies characteristics or categories associated with the discounts applied to the product."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not use deal tags as identifiers for an underlying promotion or pricing configuration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Different discounts can share the same tag, and the tags do not expose the rules used to calculate the price."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["More than one tag can be returned for a product."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following deal tags can be returned per 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":"Tag"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"130px"}},"children":["Tag"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"3.2"},"children":["3.2"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"3.3"},"children":["3.3"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"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":["black_friday"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies a discount associated with the Black Friday promotion."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limited_time_deal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies a discount with time-sensitive eligibility."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logged_in_deal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies a discount available to eligible authenticated travellers. Previously referred to as Secret deals."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mobile_rate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies a discounted rate available to eligible travellers using a mobile platform."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["seasonal_deal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✗"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies a seasonal promotional discount. Available only in version 3.2; replaced by more specific deal tags in version 3.3."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"version-33-seasonal-deal","__idx":8},"children":["Version 3.3 Seasonal deal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["version 3.3"]},", deal tags provide more granular classifications for promotional campaigns."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["seasonal_deal"]}," tag is replaced by these tags:"]},{"$$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":"Tag"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"130px"}},"children":["Tag"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"3.2"},"children":["3.2"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"3.3"},"children":["3.3"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"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":["early_year_deal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✗"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies a discount associated with an early-year promotional campaign."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flash_deal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✗"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies a discount associated with a flash promotional campaign."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getaway_deal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✗"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies a discount associated with a getaway promotional campaign."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["late_escape_deal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✗"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies a discount associated with a late-escape promotional campaign."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Do not infer pricing configuration from deal tags"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Deal tags are API-level classifications intended to describe characteristics of a discount. They do not expose the underlying pricing configuration and should not be used to infer it."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"combining-discounts","__idx":9},"children":["Combining discounts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A product can be eligible for more than one type of discount."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This request supplies the country, platform and authentication context used to determine eligibility."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n\n  \"booker\": {\n    \"platform\": \"mobile\",\n    \"country\": \"es\",\n    \"user_groups\": [\"authenticated\", \"genius\"]\n  },\n  \"checkin\": \"2026-12-05\",\n  \"checkout\": \"2026-12-14\",\n  \"extras\": [\"products\"],\n  \"guests\": {\n    \"number_of_adults\": 2,\n    \"number_of_rooms\": 1\n  }\n\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API returns applicable discounts according to the traveller’s eligibility, your partner configuration and any rate-stacking settings."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deal.discount_percentage"]}," to understand the total discount represented in the response. Do not calculate it by adding or interpreting the values in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deal.tags"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Check your partner configuration"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact your Account Manager to confirm which rate and discount programmes your integration can access, and whether rate stacking is enabled."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-guides","__idx":10},"children":["Related guides"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/display-discounts"},"children":["Displaying discounts"]}," — how to present discount information to travellers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/search-for-available-properties"},"children":["Search for available properties"]}," — how to construct accommodation search requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/prices-accommodations"},"children":["Accommodation pricing guide"]}," — how to interpret accommodation price fields and charges"]}]}]}]},"headings":[{"value":"Retrieve deals, target and CUG rates","id":"retrieve-deals-target-and-cug-rates","depth":1},{"value":"How rates and discounts are retrieved","id":"how-rates-and-discounts-are-retrieved","depth":2},{"value":"Provide the traveller context","id":"provide-the-traveller-context","depth":2},{"value":"CUG rates and authentication","id":"cug-rates-and-authentication","depth":3},{"value":"Search for target rates","id":"search-for-target-rates","depth":3},{"value":"Understand discounts in responses","id":"understand-discounts-in-responses","depth":2},{"value":"Example - Search response with discounts","id":"example---search-response-with-discounts","depth":3},{"value":"Deal tags","id":"deal-tags","depth":3},{"value":"Version 3.3 Seasonal deal","id":"version-33-seasonal-deal","depth":4},{"value":"Combining discounts","id":"combining-discounts","depth":2},{"value":"Related guides","id":"related-guides","depth":2}],"frontmatter":{"title":"Retrieve deals, target and CUG rates","description":"Learn how to request accommodation deals, target rates and closed user group rates, then interpret the discount information returned by Demand API v3.2 and v3.3.","tags":["demand-api","accommodations","discounts","deals","target-rates","cug-rates"],"api":["/accommodations/search","/accommodations/availability","/orders/preview"],"keywords":["retrieve accommodation discounts","accommodation deals","target rates","mobile rates","geo rates","CUG rates","products.deal"],"x-redocly":{"seo":{"title":"Retrieve accommodation deals, target and CUG rates","description":"Use traveller context to retrieve eligible accommodation deals and rates, and understand the discount fields and `tags` returned by the Demand API."},"audience":["developer","partners","business"],"apiVersion":"v3.2, v3.3"},"product":"accommodation","seo":{"title":"Retrieve deals, target and CUG rates"}},"lastModified":"2026-11-05T13:49:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/accommodations/discounts-target","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}