# Changelog

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

# March 2026

This release focuses on Demand API version 3.2 and 3.2 Beta, with significant updates across car rentals and orders:

div
strong
What´s new
ul
li
strong
Car rentals – v3.2 / 3.2 Beta:
ul
li
code
insurance
 – Object added in cars/search, cars/availability and orders/preview to support optional book of third-party insurance for a vehicle.
li
code
cars.payment.timing
 – Field in orders/details to indicate when the traveller is expected to pay for the car rental order (
code
pay_online_now
, 
code
pay_at_pickup
, 
code
unknown
).
li
strong
Attractions – 3.2 Beta:
ul
li
code
categories
 – New filter in attractions/search to allow filtering results by one or more attraction category IDs (e.g. tours, museums, etc).
li
strong
Orders – v3.2 / 3.2 Beta:
ul
li
code
occupancy_mismatch
 – New warning object in orders/preview to indicate when requested guest allocation exceeds product maximum occupancy. Provides 
code
allocated
 and 
code
unallocated
 breakdown.
li
 orders/cancel for cars – This endpoint supports now car orders cancellations.
li
 New orders/modify/preview – New consultive endpoint to validate whether a modification before confirming the change.
## Car rentals

### Insurance optional add-on

**|** v3.2 3.2 Beta **|** **New field: insurance** **|**

> The new `insurance` object under each product in the cars response provides information about any optional insurance traveller can book for the rental.
* Only present when configured for the partner.
* `null` if not available.



Available in:

* [/cars/search](/demand/docs/open-api/3.2/demand-api/cars/search)
* [/cars/availability](/demand/docs/open-api/3.2-beta/demand-api/cars/availability)
* [/orders/preview](/demand/docs/open-api/3.2-beta/demand-api/orders/orders/preview)


Example in search response:


```json
"insurance": {
  "name": "Full Protection",
  "id": "999",
  "price": {
    "amount": 144.70,
    "currency": "EUR"
  }
}
```

The `insurance` field differes from `policies.insurance_package`, which represents the supplier’s default insurance package. See the [Insurance dedicated guide](/demand/docs/cars/3.2/cars-insurance-guide) for more details.

### Cars payment timing

**|** v3.2 3.2 Beta **|** **New field: `cars.payment.timing` in orders/details** **|**

> Payment timing information is now available in the orders/details response under `cars.payment.timing`.
**Purpose** – It indicates when the traveller is expected to pay for the car rental order, enabling better post-booking experiences and financial workflows.


This field is only returned when extras: ["payment"] is included in the request.

Possible payment timing for cars:

* `pay_online_now` – Paid at booking time.
* `pay_at_pickup` – Paid locally at pickup.
* `unknown` – Timing could not be determined.


Example response:


```json
{
  "cars": {
    "payment": {
      "timing": "pay_at_pickup"
    }
  }
}
```

Use this field to clearly communicate payment expectations to travellers and align internal payment and reporting flows.

### Default car search results increased

**|** v3.2 3.2 Beta **|** **Behaviour change** **|**

> The default number of car search results returned by the /cars/search endpoint has been increased.
**Purpose** – Provides more comprehensive search results without requiring clients to set a custom limit.
* Default results increa



## References