Stay up to date with the latest enhancements to the Demand API.
This release introduces a new accommodation status field in the Accommodation API, enhances the Orders API for car booking and post-booking workflows, expands the Cars API with additional car categories, and includes several bug fixes.
- Accommodation API collectionv3.2
accommodation_statusis now available in /accommodations/details.
- Orders API collectionBeta
special_offeris now available in /orders/details/cars/live.payment.timingandpayment.methodare now optional for car bookings in /orders/create.
- Cars API collectionBetav3.2
-
Added support for
convertibleandpickupcar categories.
-
Added support for
- Bug fix: Dummy text removed from cars/depots and cars/suppliers results.
|v3.2 | New field | accommodation_status |
What changed?
The
accommodation_statusfield is now included in the /accommodations/details response. It indicates whether an accommodation is operational, temporarily closed, permanently closed, or closed due to fraud-related Trust & Safety concerns.Why it matters
This is useful when querying specific accommodation IDs, as
closedaccommodations are returned only for ID-based requests.
The field can contain the following values:
openclosed_temporarilyclosed_permanentlyclosed_fraud(returned only when fraud visibility is enabled for your account; otherwise reported as closed_permanently)
Available in:
Note: When querying by location (airport, city, country, or region), only accommodations with status open are returned.
| Beta | New field | special_offer |
What changed?
The
special_offerfield is now included in the /orders/details/cars/live response. It returns any promotional or complimentary features that were included when the traveller made the reservation.Why it matters
You can now retrieve this information after booking and display the traveller's special offer in your post-booking or "Manage booking" experience.
The field can contain values such as:
- Baby or child seat included.
- GPS included.
- Wi-Fi device included.
- Priority pick-up.
- Complimentary vehicle upgrade.
- Additional driver included.
Available in:
Also available in:
Example:
{
"car": {
"id": 803765581,
"image": "https://example.com/images/car_compact.jpg",
"category": "Compact",
"transmission": "Automatic",
"doors": "4",
"seats": "5",
"air_conditioning": true,
"big_suitcase": "2",
"small_suitcase": "1",
"currency": "EUR",
"make_and_model": "Toyota Corolla",
"special_offer": "Baby/child seat included",
"supplier": {
"id": "SUP123",
"name": "Avis",
"telephone": "+353 1 800 123456",
"confirmation_number": "ZYX987"
}
}
}| Beta|v3.2| New values| car_categories |
The
car_categoriesfilter now supports two additional values:
convertiblepickupThese categories can be used when filtering search results and are also returned by the constants endpoint.
Available in:
| Beta| Behaviour change| payment.timing, payment.method optional |
When creating car orders:
payment.timingandpayment.methodare now optional.- If
payment.methodis provided, it must be"card".
These changes apply only to car orders.
Available in:
| Beta|v3.2| Bug fix| Supplier and depot results cleaned up |
The /cars/suppliers endpoint now filters out suppliers whose names contain
test, preventing test suppliers from being returned in production responses.The /cars/depots endpoint now filters out depots whose names contain
zzz.