Updated accommodations

Request

Use this endpoint to track accommodations that have opened, closed, or had relevant content updates since a specific timestamp. Changes can include updates to general information, facilities, rooms, photos, payments, and more.
You can:
- Filter results by country or city.
- Use the "next" timestamp from the response to request further updates.

To keep your local accommodation cache up to date, use this endpoint in combination with accommodations/details

The maximum number of IDs returned is approximately 5000 per request.

Security

BearerAuth

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/json

last_changestring, (date-time)required

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

filtersobject

parameter basis which filtering needs to be done. Only one of (countries or cities) must be provided.

curl -i -X POST \
  https://demandapi.booking.com/3.1/accommodations/details/changes \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "last_change": "!START_DATE!T12:00:00+00:00",
    "filters": {
      "countries": [
        "nl",
        "es",
        "in"
      ]
    }
  }'

Responses

Successful response.

Bodyapplication/json

request_idstring

Uniquely identifies the request. Please provide this identifier when contacting support.

dataobject(AccommodationDetailsChangesDataOutput)

Response

{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": {
    "changes": { … },
    "from": "!START_DATE!T12:00:00+00:00",
    "next": "!START_DATE!T12:24:42+00:00",
    "total_changes": 5125
  }
}