POST /accommodations/details/changes
This endpoint returns all accommodations that have closed, opened or changed relevant content since the given timestamp up to a limit of around 5000 ids.
Cache: It is recommended to cache accommodation information locally in order to speed up responses. Use this endpoint in combination with accommodations/details to maintain the local cache up-to-date.
The number of accommodation ids returned may vary since some may be removed due to blacklisting, while all changes from the last second will be included even if already beyond the 5000 ids threshold.
Multiple changes to the same accommodation are grouped by intervals of 30 minutes in order to reduce the number of records.
Servers
- https://demandapi.booking.com/3.1
- https://demandapi-sandbox.booking.com/3.1
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
X-Affiliate-Id |
Integer | Yes |
Include here your Affiliate identifier number |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
filters |
Object | No |
parameter basis which filtering needs to be done. Only one of (countries or cities) must be provided. |
filters.cities[] |
Array | No |
Filter changes based on these cities. The valid full list can be obtained by calling common/locations/cities. |
filters.countries[] |
Array | No |
Filter changes based on these countries. The valid full list can be obtained by calling common/locations/countries. |
last_change |
String | Yes |
The timestamp in ISO-8601 format from which changes to accommodations are returned (inclusive). Only UTC time zone is supported. We support changes for last 24 hours. Format: YYYY-MM-DDTHH:mm:ss+00:00 |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.