Sustainability certifications

Learn how to retrieve and display sustainability certification information for accommodations using Demand API v3.2.

Demand API v3.2 provides information about third-party sustainability certifications awarded to accommodation properties.

• Use the /accommodations/search endpoint to filter search results to return only accommodations with sustainability certification information.
• Use the /accommodations/details endpoint to retrieve this information and display it alongside the relevant accommodation details in your application.

The programmes object can also contain information about other Booking.com programmes, such as the Travel Proud badge.

Booking.com uses certification schemes that declare compliance with applicable sustainability criteria. For more information, see Travalyst.

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.

Sustainability programmes are not publicly available by default in Demand API v3.1.

If you use Demand API v3.1:

• Access requires activation at Partner ID level.
• The feature is not enabled by default.
• Contact your Booking.com Account Manager to request activation or confirm availability.
• The Sustainable Offerings Programme API specifications are not publicly available on this portal.

For publicly documented sustainability functionality, use Demand API v3.2.

In v3.2, use:

• filters.sustainability_certification in /accommodations/search.
• programmes.sustainable_offerings.certifications in /accommodations/details.

Use sustainability certification information when you want to:

• Help travellers make more informed accommodation choices.
• Display certification information alongside accommodation details.
• Allow travellers to find accommodations with recognised sustainability certifications.
• Provide additional context about an accommodation’s sustainability credentials.

To use sustainability information, make sure that:

• You have access to the Demand API.
• You have completed the Getting started prerequisites list.
• Your integration uses Demand API v3.2.
• Sustainability information has been activated for your Partner ID, where required.
• You are familiar with the /accommodations/search and /accommodations/details endpoints.

To request access or confirm feature availability, contact your Booking.com Account Manager.

A typical integration works as follows:

1. Search for accommodations using the /accommodations/search endpoint.
2. Optionally filter results using filters.sustainability_certification.
3. Retrieve accommodation details using /accommodations/details.
4. Check whether the response contains one or more objects in programmes.sustainable_offerings.certifications.
5. Display the certification information next to the relevant accommodation.
6. Preserve the certification name returned by the API.
7. Retrieve updated accommodation details when your application needs to refresh property information.

Filter search results to return only accommodations with recognised sustainability certifications:

• Use filters.sustainability_certification in the /accommodations/search request.
• Set the value to true to request accommodations with recognised sustainability certification information.

Example:

{
  "filters": {
    "sustainability_certification": true
  }
}

The filter only affects the search results. To retrieve the certification name and display it to travellers, request the accommodation details separately using /accommodations/details.

Use the /accommodations/details endpoint to retrieve detailed information about an accommodation.

The sustainability information is returned within the accommodation object in the response data array:

Example response:

{
  "data": [
    {
      "id": 10004,
      "programmes": {
        "travel_proud": false,
        "sustainable_offerings": {
          "certifications": [
            {
              "name": "Green Key"
            },
            {
              "name": "Green Globe"
            }
          ]
        }
      }
    }
  ]
}

Sustainability fields are optional.

Your application should support the following response scenarios:

• programmes is not returned.
• sustainable_offerings is returned without certifications.
• certifications is returned as an empty array.
• One or more certification objects are returned.

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.

When certification data is returned, use each certifications[].name value exactly as provided by the API.

When displaying sustainability certification information:

• Preserve the certification name returned by the API.
• Do not rename, reinterpret, or replace the certification name.
• Display the information next to the relevant accommodation.
• Keep sustainability certification information visually distinct from the Travel Proud badge.
• Do not imply that a certification guarantees a particular environmental outcome.

For a clear and reliable traveller experience:

• Offer the sustainability certification filter available in Demand API v3.2.
• Display certification information on accommodation search results and detail pages where appropriate.
• Use the accommodation ID to associate the certification with the correct accommodation.
• Treat certification information as optional.
• Avoid hard-coding certification names in your application.
• Do not create your own certification categories or rankings from the returned data.
• Retrieve updated accommodation details when your application needs to refresh property information.
• Follow the caching, retention, and data-use requirements in your Demand API agreement.

Travel Proud is a separate Booking.com programme and should not be presented as a sustainability certification.

If the response contains:

{
  "programmes": {
    "travel_proud": true
  }
}

• Display the Travel Proud badge according to the applicable Booking.com presentation guidelines.
• Do not use travel_proud to infer anything about an accommodation’s environmental practices or sustainability certifications.

Refer to your Demand API agreement for the requirements governing the presentation, use, retention, and redistribution of accommodation information.

In particular:

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.

You are responsible for the framing, context, and presentation of sustainability information within your own products and services.

Sustainability information is provided exclusively for displaying Booking.com accommodation information to travellers.

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.

Sustainability information can change when certifications are awarded, renewed, suspended, or withdrawn.

To help keep displayed information accurate:

• Retrieve sustainability information from the Demand API rather than maintaining a manually managed certification list.
• Avoid hard-coding certification information.
• Refresh accommodation details according to your application’s data-refresh strategy and the requirements of your Demand API agreement.
• Do not display stale information indefinitely.

The /accommodations/details endpoint provides static accommodation information. It does not provide availability or pricing.