Stay up to date with the latest enhancements to the Demand API.
This release focuses on expanding accommodation inventory capabilities and improving the car booking experience with enhancements across the Accommodation, Cars, and Orders API collections.
- Accommodation API collection
-
Added support for identifying third-party suppliers through
inventory.third_party_supplier_idin /accommodations/availability. - New /accommodations/third-party-suppliers endpoint to retrieve supplier details.
-
Added support for identifying third-party suppliers through
- Cars API collection
-
Added new
fuel_types,price, andrating.minimum_review_scoresearch filters to /cars/search. -
Added the
recommendedvalue forsort.by. -
Added
compact_suv,midsize_suv, andlarge_suvvehicle categories for car search filtering and in /cars/constants.
-
Added new
- Orders API collection
- Updated driver and booker requirements for car order requests in /orders/create.
loyalty_rewardis now returned for eligible car rental orders in /orders/details.-
Added
insurance.documentsto /orders/details/cars/live for retrieving insurance documents.
| Beta | v3.2 | New field | inventory.third_party_supplier_id |
The /accommodations/availability response now includes
inventory.third_party_supplier_id, allowing you to identify the third-party supplier for accommodation inventory.Use this value with /accommodations/third-party-suppliers to retrieve supplier details.
Available in:
- /accommodations/availability (v3.2 and Beta)
Example:
{
"inventory": {
"third_party": true,
"type": "sell",
"third_party_supplier_id": 123
}
}
| Beta | v3.2 | New endpoint | /accommodations/third-party-suppliers |
Added the /accommodations/third-party-suppliers endpoint for retrieving supplier details associated with third-party accommodation inventory.
Use the returned
idto match theinventory.third_party_supplier_idvalue from /accommodations/availability.
This endpoint is currently available in v3.2 and Beta.
Available in:
Example:
{
"request_id": "01fr9ez700exycb98w90w5r9sh",
"data": [
{
"id": 101,
"name": "Example Supplier",
"company_address": "123 Example Street, 1000 Amsterdam, Netherlands"
}
]
}| Beta | v3.2 | Enhancement | filters.fuel_types, filters.price, and filters.rating.minimum_review_score |
Added new optional filters to /cars/search to help narrow search results:
fuel_typesfilters vehicles by one or more fuel types.pricefilters vehicles within a minimum and/or maximum total rental price.rating.minimum_review_scorefilters vehicles by the minimum review score of the pickup depot.
Available in:
Example:
{
"filters": {
"fuel_types": [
"electric",
"plug_in_hybrid"
],
"price": {
"minimum": 100,
"maximum": 300
},
"rating": {
"minimum_review_score": 8
}
}
}| Beta | v3.2 | New value | filters.car_categories |
Added three new SUV categories to help you refine car searches and classify vehicle types more precisely:
compact_suvmidsize_suvlarge_suvThese values are supported when filtering search results using
filters.car_categoriesin /cars/search and are also returned by /cars/constants.
Available in:
Example:
{
"filters": {
"car_categories": [
"compact_suv",
"midsize_suv"
]
}
}
| Beta | v3.2 | New value | sort.by = "recommended" |
A new
recommendedvalue has been added to thesort.byfield for /cars/search.Use this value to explicitly return results using Booking.com's recommended ranking.
Available in:
Example:
{
"sort": {
"by": "recommended"
}
}| Beta | Behaviour change | Updated required fields for driver and booker information |
We've updated the required contact information for car booking requests.
| Field | Change |
|---|---|
driver.email | Now required |
driver.telephone | Now required |
driver.address | No longer required |
booker.address.address_line, city, country, post_code | Remain required when booker.address is provided |
Available in:
| v3.2 | Beta | Enhancement | loyalty_reward |
The
loyalty_rewardobject is now returned for eligible car rental orders through /orders/details, providing a consistent response across accommodation and car bookings for reporting enhancements.
Available in:
| Beta | New field | insurance.documents |
The /orders/details/cars/live endpoint now includes
insurance.documentsobject for purchased insurance products.Each document includes a retrieval
statusand, when available, a downloadurl.Supported document types are:
policy_document– The full insurance policy, including terms, conditions, exclusions, and cancellation rules.ipid– The Insurance Product Information Document (IPID), providing a summary of key coverage information.certificate– The Certificate of Insurance (COI), providing proof that cover is in place.
This feature is currently available only in the Beta /orders/details/cars/live endpoint.
See the Car insurance guide for implementation details.