Skip to content
Last updated

Changelog

Stay up to date with the latest enhancements to the Demand API.

December 2025

This release brings new features and improvements across different API collections:

  • Accommodations: Bundles and value-added services available in v3.2.
  • Car rentals: Drop-off dates no longer limited to 500 days, allowing full 180-day rentals.
  • Attractions:urls block now includes both app and web links to details and search results.
  • Orders: Room-level modifications supported for online payments; new orders/details/cars/faqs endpoint (v3.2 Beta) provides car rental FAQs in requested languages.

Accommodations

| v3.2| | Bundles and value added services |

Bundles and value added services are now available in accommodation endpoints, as well as in orders/details and orders/preview.

Example of accommodations/details response with value added services:

{
  "request_id": "01kcrwnk8b1kv5syq2mbjfjy3n",
  "data": [
    {
      "id": 13766008,
      "name": {
        "en-gb": "Beach Apartment",
        "es": "Beach Apartment"
      },
      "accommodation_type": 201,
      "booker_address_required": false,
      "brands": [],
      "bundles": [
        {
          "id": 843543,
          "value_adds": [
            {
              "description": {
                "es": [
                  "Parking para un vehículo por unidad reservada y estancia."
                ],
                "en-gb": [
                  "Self parking for one vehicle per booked unit per stay."
                ]
              },
              "type": "parking"
            },
            {
              "description": {
                "es": [
                  "Internet de alta velocidad durante toda la estancia."
                ],
                "en-gb": [
                  "High-speed internet throughout your stay."
                ]
              },
              "type": "high_speed_internet"
            }
          ]
        }
      ],

See all details in the bundles guide.

Car rentals

| v3.2 | v3.1 | Drop-off date extension |

  • Drop-off dates are no longer limited to a fixed number of days from the current date, allowing full 180-day rental durations from the maximum allowed pickup date.

Existing validation rules (e.g., pickup and drop-off dates must be in the future and not identical) continue to apply.

Attractions

| 3.2 Beta | URLs block refinement |

The urls block returned in attractions/details, attractions/search responses, now includes both app and web links to the attraction details page and search results.

Example of attractions/search response with urls:

{
  "data": [
    {
      "id": "PRahAzWtTraa",
      "free_cancellation": true,
      "price": {
        "currency": "EUR",
        "total": 20
      },
      "urls": {
        "app": {
          "detail": "booking://attractions/product?slug=prahazwttraa-heineken-experience-amsterdam&aid=956509",
          "search_results": "booking://attractions/searchresults?ufi=-2140479&pinned_product_id=PRahAzWtTraa&aid=956509"
        },
        "web": {
          "detail": "https://www.booking.com/attractions/nl/prahazwttraa-heineken-experience-amsterdam.en-gb.html?selected_currency=EUR&aid=956509",
          "search_results": "https://www.booking.com/attractions/searchresults/nl/amsterdam.en-gb.html?pinned_product=PRahAzWtTraa&aid=956509"
        }
      }
    },

Orders

| <span style="background-color:#0070c9; color:white; font-size:0.8rem; padding:0.2rem 0.5rem; border-radius:4px;">v3.2</span> | <span style="background-color:#D3E2F2; color:#1f3a5f; font-size:0.8rem; padding:0.2rem 0.5rem; border-radius:4px; border:1px solid #B7CDE6;"> v3.1 </span> | Room-level modifications for online payments |

> * orders/modify now supports room-level modifications (name, guest quantity and preferences) for reservations paid online.

| 3.2 Beta | New | orders/details/cars/faqs |

Example response for en, fr, de and es languages:

{
  "request_id": "123456789",
  "data": {
    "faqs": [
      {
        "question": {
          "en-gb": "What if I haven’t received my booking confirmation?",
          "fr": "Que dois-je faire si je n'ai pas reçu ma confirmation de réservation ?",
          "de": "Was ist, wenn ich meine Buchungsbestätigung nicht erhalten habe?",
          "es": "¿Qué hago si no he recibido la confirmación de mi reserva?"
        },
        "answers": {
          "en-gb": [
            "Most bookings are confirmed straight away, so please check your spam folder if there’s nothing in your inbox.",
            "You can always check the status of your booking online:",
            "If you’re using the app, tap ‘Bookings’ at the bottom of the screen.",
            "If you’re using the website, make sure you’re signed in and on the ‘Car rentals’ page - then hit ‘Manage booking’ at the top.",
            "If you find that your booking isn’t confirmed yet, we’re working on it and we’ll email you as soon as it is."
          ],
          "fr": [
            "La plupart des réservations sont immédiatement confirmées. Si vous n'avez pas reçu d'e-mail, veuillez vérifier vos spams.",
            "Vous pouvez également consulter le statut de votre réservation en ligne.",
            "Sur l'application, appuyez sur « Réservations » en bas de l'écran.",
            "Sur le site Internet, connectez-vous à votre compte et rendez-vous sur la page « Voitures de location »."
          ],
          "de": [
            "Die meisten Buchungen werden sofort bestätigt. Bitte überprüfen Sie Ihren Spam-Ordner.",
            "Sie können den Status Ihrer Buchung jederzeit online einsehen."
          ],
          "es": [
            "La mayoría de las reservas se confirman al momento. Revisa la carpeta de spam si no ves el correo.",
            "Puedes consultar el estado de tu reserva online en cualquier momento."
          ]
        }
      }
    ]
  }
}

References

v3.2 API reference

Check the 3.2 version specifications and give them a try in the console to return the new fields.

Check now

Beta API reference

Check the Beta API collections. You need specific credentials to test them out - Contact your Booking Account Manager if interested.

Check now