{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Sustainability certifications","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"sustainability-certifications","__idx":0},"children":["Sustainability certifications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learn how to retrieve and display sustainability certification information for accommodations using Demand API v3.2."]}]},{"$$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":["Demand API v3.2 provides information about third-party sustainability certifications awarded to accommodation properties."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/search"},"children":["/accommodations/search"]}," endpoint to filter search results to return only accommodations with sustainability certification information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/details"},"children":["/accommodations/details"]}," endpoint to retrieve this information and display it alongside the relevant accommodation details in your application."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["programmes"]}," object can also contain information about other Booking.com programmes, such as the Travel Proud badge."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Booking.com uses certification schemes that declare compliance with applicable sustainability criteria. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://travalyst.org/"},"children":["Travalyst"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide explains how to retrieve and display sustainability information. It does not provide a complete list of recognised certification programmes, as these may change over time."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sustainability information is optional and may not be returned for every property. If the relevant fields are absent, do not assume that the accommodation has no sustainability certification."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"demand-api-v31-availability","__idx":2},"children":["Demand API v3.1 availability"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sustainability programmes are not publicly available by default in Demand API v3.1."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you use Demand API v3.1:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access requires activation at Partner ID level."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The feature is not enabled by default."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact your Booking.com Account Manager to request activation or confirm availability."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Sustainable Offerings Programme API specifications are not publicly available on this portal."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following fields are deprecated in Demand API v3.1 and removed in Demand API v3.2:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chain_programmes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["practices"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not use these fields when developing a new integration. If your v3.1 integration currently relies on them, contact your Booking.com Account Manager for migration guidance."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For publicly documented sustainability functionality, use Demand API v3.2."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In v3.2, use:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.sustainability_certification"]}," in /accommodations/search."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["programmes.sustainable_offerings.certifications"]}," in /accommodations/details."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-use-this-feature","__idx":3},"children":["When to use this feature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use sustainability certification information when you want to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Help travellers make more informed accommodation choices."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display certification information alongside accommodation details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Allow travellers to find accommodations with recognised sustainability certifications."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide additional context about an accommodation’s sustainability credentials."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":4},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To use sustainability information, make sure that:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You have access to the Demand API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You have completed the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/getting-started/prerequisites"},"children":["Getting started prerequisites"]}," list."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your integration uses Demand API v3.2."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sustainability information has been activated for your Partner ID, where required."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You are familiar with the /accommodations/search and /accommodations/details endpoints."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To request access or confirm feature availability, contact your Booking.com Account Manager."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":5},"children":["How it works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A typical integration works as follows:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search for accommodations using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/search"},"children":["/accommodations/search"]},"  endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally filter results using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.sustainability_certification"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve accommodation details using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/details"},"children":["/accommodations/details"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check whether the response contains one or more objects in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["programmes.sustainable_offerings.certifications"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display the certification information next to the relevant accommodation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Preserve the certification name returned by the API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve updated accommodation details when your application needs to refresh property information."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search-for-accommodations-with-sustainability-certifications","__idx":6},"children":["Search for accommodations with sustainability certifications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Filter search results to return only accommodations with recognised sustainability certifications:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.sustainability_certification"]}," in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/search"},"children":["/accommodations/search"]},"  request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the value to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," to request accommodations with recognised sustainability certification information."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"filters\": {\n    \"sustainability_certification\": true\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The filter only affects the search results. To retrieve the certification name and display it to travellers, request the accommodation details separately using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/details"},"children":["/accommodations/details"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The availability and behaviour of this filter may depend on your Demand API version and feature access. Check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/search"},"children":["/accommodations/search"]},"  API reference for the schema supported by your integration."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"retrieve-sustainability-information","__idx":7},"children":["Retrieve sustainability information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/details"},"children":["/accommodations/details"]}," endpoint to retrieve detailed information about an accommodation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The sustainability information is returned within the accommodation object in the response data array:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"data\": [\n    {\n      \"id\": 10004,\n      \"programmes\": {\n        \"travel_proud\": false,\n        \"sustainable_offerings\": {\n          \"certifications\": [\n            {\n              \"name\": \"Green Key\"\n            },\n            {\n              \"name\": \"Green Globe\"\n            }\n          ]\n        }\n      }\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The certification names in this example are illustrative and do not necessarily reflect the values returned by the API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"response-fields","__idx":8},"children":["Response 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":{"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":["programmes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains information about Booking.com programmes associated with the accommodation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["programmes.sustainable_offerings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains sustainability-related information available for the accommodation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["programmes.sustainable_offerings.certifications"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An array of sustainability certification objects."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["programmes.sustainable_offerings.certifications[].name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The certification name returned by the API."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"handle-optional-sustainability-information","__idx":9},"children":["Handle optional sustainability information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sustainability fields are optional."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your application should support the following response scenarios:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["programmes"]}," is not returned."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sustainable_offerings"]}," is returned without ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["certifications"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["certifications"]}," is returned as an empty array."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["One or more certification objects are returned."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not treat a missing field as proof that an accommodation has no certification. It may indicate that the information is unavailable for that accommodation or was not included in the response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When certification data is returned, use each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["certifications[].name"]}," value exactly as provided by the API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"display-requirements","__idx":10},"children":["Display requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When displaying sustainability certification information:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Preserve the certification name returned by the API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not rename, reinterpret, or replace the certification name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display the information next to the relevant accommodation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep sustainability certification information visually distinct from the Travel Proud badge."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not imply that a certification guarantees a particular environmental outcome."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"implementation-recommendations","__idx":11},"children":["Implementation recommendations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a clear and reliable traveller experience:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Offer the sustainability certification filter available in Demand API v3.2."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display certification information on accommodation search results and detail pages where appropriate."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the accommodation ID to associate the certification with the correct accommodation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treat certification information as optional."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid hard-coding certification names in your application."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not create your own certification categories or rankings from the returned data."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve updated accommodation details when your application needs to refresh property information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Follow the caching, retention, and data-use requirements in your Demand API agreement."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"travel-proud-information","__idx":12},"children":["Travel Proud information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Travel Proud is a separate Booking.com programme and should not be presented as a sustainability certification."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the response contains:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"programmes\": {\n    \"travel_proud\": true\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display the Travel Proud badge according to the applicable Booking.com presentation guidelines."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["travel_proud"]}," to infer anything about an accommodation’s environmental practices or sustainability certifications."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"partner-responsibilities","__idx":13},"children":["Partner responsibilities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Refer to your Demand API agreement for the requirements governing the presentation, use, retention, and redistribution of accommodation information."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In particular:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"regulatory-compliance","__idx":14},"children":["Regulatory compliance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You are responsible for ensuring that sustainability information displayed to travellers complies with all applicable local and international laws and regulations, in accordance with Clause 7.1.b of your agreement."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"presentation-of-information","__idx":15},"children":["Presentation of information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You are responsible for the framing, context, and presentation of sustainability information within your own products and services."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"data-usage","__idx":16},"children":["Data usage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sustainability information is provided exclusively for displaying Booking.com accommodation information to travellers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must not use this information to create, enhance, supplement, or operate your own sustainability programme, rating system, certification database, or similar service, in accordance with Clause 11.5 of your agreement."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"data-freshness","__idx":17},"children":["Data freshness"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sustainability information can change when certifications are awarded, renewed, suspended, or withdrawn."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To help keep displayed information accurate:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve sustainability information from the Demand API rather than maintaining a manually managed certification list."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid hard-coding certification information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refresh accommodation details according to your application’s data-refresh strategy and the requirements of your Demand API agreement."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not display stale information indefinitely."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/details"},"children":["/accommodations/details"]}," endpoint provides static accommodation information. It does not provide availability or pricing."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"implementation-checklist","__idx":18},"children":["Implementation checklist"]},{"$$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":"Check"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"60px"}},"children":["Check"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Requirement"},"children":["Requirement"]},{"$$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":"td","attributes":{},"children":["Use Demand API v3.2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sustainability offerings are publicly available as a feature in version 3.2."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm access."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm that your Partner ID can use sustainability-related functionality."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use a supported version."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use Demand API v3.1 or later, according to the feature availability for your integration."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve accommodation details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/details"},"children":["/accommodations/details"]}," to retrieve the programmes object."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Handle optional fields"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not assume that missing sustainability fields mean that an accommodation has no certification."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preserve certification names"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display certification names as returned by the API."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Separate Travel Proud"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display Travel Proud independently from sustainability certifications."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Follow data-use requirements"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use the information only as permitted by your Demand API agreement."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":19},"children":["Next steps"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact your Booking.com Account Manager if you need access to sustainability-related functionality or approved presentation assets."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Read the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/details"},"children":["accommodations/details API reference"]}," for the response schema."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Read the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/search"},"children":["accommodations/search API reference"]}," to confirm search-filter availability and behaviour."]}]}]}]},"headings":[{"value":"Sustainability certifications","id":"sustainability-certifications","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Demand API v3.1 availability","id":"demand-api-v31-availability","depth":3},{"value":"When to use this feature","id":"when-to-use-this-feature","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"How it works","id":"how-it-works","depth":2},{"value":"Search for accommodations with sustainability certifications","id":"search-for-accommodations-with-sustainability-certifications","depth":3},{"value":"Retrieve sustainability information","id":"retrieve-sustainability-information","depth":3},{"value":"Response fields","id":"response-fields","depth":4},{"value":"Handle optional sustainability information","id":"handle-optional-sustainability-information","depth":3},{"value":"Display requirements","id":"display-requirements","depth":2},{"value":"Implementation recommendations","id":"implementation-recommendations","depth":2},{"value":"Travel Proud information","id":"travel-proud-information","depth":2},{"value":"Partner responsibilities","id":"partner-responsibilities","depth":2},{"value":"Regulatory compliance","id":"regulatory-compliance","depth":3},{"value":"Presentation of information","id":"presentation-of-information","depth":3},{"value":"Data usage","id":"data-usage","depth":3},{"value":"Data freshness","id":"data-freshness","depth":3},{"value":"Implementation checklist","id":"implementation-checklist","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Sustainability certifications","description":"Learn how to retrieve and display sustainability certification information for accommodations using the Demand API.","tags":["demand-api","accommodations","sustainability","certifications","accommodation details"],"api":["/accommodations/search","/accommodations/details"],"x-redocly":{"seo":{"title":"Sustainability certifications | Booking.com Demand API","description":"Learn how to retrieve and display sustainability certification information for accommodations using the Demand API."},"audience":["developer","partner","integrator"],"apiVersion":["v3.2"],"product":["accommodation"]},"seo":{"title":"Sustainability certifications"}},"lastModified":"2026-08-26T11:22:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/accommodations/sustainability/about","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}