CHANGELOG
Last updated

Changelog

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

November 2025

🎉 Demand API version 3.2 is live!

Demand API v3.2 introduces a major improvement across travel services API collections, focusing on consistency, simplified flows, and clearer data structures.

This release includes breaking changes and new features across Accommodations, Orders, Cars, Messaging and Attractions.

Key highlights

  • Unified structures such as harmonised price and charge breakdowns, consistent identifier types, new metadata objects, and aligned URL formats.
  • Simplified booking flows, including merged availability endpoints for accommodations and new Cars endpoints supporting a full search–book journey (in Beta).
  • Improved clarity and transparency with new property status values, updated payment timings, and more explicit inventory structures.
  • New functionality, including support for “Cancel for less” in v3.2 and in Beta: expanded Attractions endpoints and message acknowledgement in the Messaging API.
  • Breaking changes across multiple endpoints requiring integration updates.

See Migration guide for details.

Across endpoints

| v3.2 | New | Breaking changes |

Consistent identifier types: room.id and reservation id are now strings

  • products.room ID string to support unmapped rooms.
  • reservation ID string for consistency with other travel services.

Harmonised price breakdown

  • Aligned excluded and included charges across endpoints.
  • book price renamed to display price.
  • commission and price transformed into objects now including multi-currency (booker.currency and product.currency).

Metadata object

  • Paginated endpoints now include next_page token and total_results under a "Metadata" object.
  • Purpose: More organised metadata information in line to cars and attractions responses.

Accommodation

| v3.2 | New | Breaking changes |

/accommodations/availability

| v3.2 | New | Merged endpoints |

  • accommodations/availability and /bulk-availability endpoints are now consolidated.
  • Purpose: Simplify integration and reduce redundancy in availability requests.
/accommodations/details

| v3.2 | New |

Cancel for less support

New field: include extras.refuses_free_cancellation_requests to support the "Cancel for less" functionality. See guide for details.

URL object

  • web and app URLs now nested under url object instead of deep_link_url.
  • Purpose: Alignment with Cars API and improved consistency.

Property status expansion

  • Added the following new property status values:
    • temporarily_closed
    • permanently_closed
    • fraud - Accommodations closed due to confirmed fraudulent activity.
  • Purpose: More transparency on property status.

| v3.2 | Breaking |

cribs_and_extra_beds removed

Use cots_and_extra_beds instead. Purpose: Standardise bed/crib handling.

is_work_friendly removed

is_work_friendly replaced by work_friendly. Purpose: Standardise terminology.

third_party_inventory removed

Replaced by new inventory object.

Orders

| v3.2 | New | Breaking changes |

Deprecated fields removed

  • cavv and credit_slip - use credit_slip_number instead.
  • commission.actual_amount - use commission.actual_commission_amount instead.

Update billing/commission calculations to use actual_commission_amount:

  • product_currency for product-level accounting.
  • booker_currency for user-facing reporting.

Retrieve Attractions

/orders/details now also retrieves Attractions bookings alongside Accommodations and Cars, mainly for reporting tasks.

Learn more about Attractions here.

Cars

| 3.2 Beta | New | Breaking changes |

New endpoints

Some new endpoints have been added to support the Search, look and book flow in Beta:

EndpointUse it to ...Response
/cars/availabilityTo retrieve real-time availability details for a specific car rental offer.The response includes information about pricing, payment options, policies (such as cancellation, mileage, and fuel), and available extras.
/cars/terms-and-conditionsTo retrieve the terms and conditions for a specific car rental offer during the pre-booking process.The response includes structured, localised content in the requested language, covering key policies such as driver requirements, mileage, deposits, and damage excess.
/orders/cars/terms-and-conditionsTo retrieve the terms and conditions for a specific car rental order after booking.The response includes the car rental contract details, including chapters, sections, clauses, and clause options.

Depot fields updated

/cars/depots deskAt removed - use depot_location_type.

Payment timings renamed

payment timings renamed for consistency with accommodation timings: pay_online_now, pay_partial_online_now, pay_at_pickup.

offer and search_token

/cars/search now returns fleetCarId and carId in an offer and search_token needed for the car rental booking (using orders/preview and orders/create)

See Search, look and book tutorial for cars.

Messaging API

| 3.2 Beta | New |

The major change added to Messaging API collection is:

  • New confirmedMessages field returned in /messages/latest/confirmed response.
  • Purpose: Acknowledge of reception.

Attractions

| 3.2 Beta | New |

New endpoints available

Attractions endpoints are now available in Beta, enabling search, availability, and booking of attractions through the Demand API.

Check them out!

References

v3.2 Migration guide

Learn how to migrate from version 3.1 to version 3.2, incorporating new features and endpoints.

Read now

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