Check availability

Request

Use this endpoint to return detailed product availability, price and charges of the accommodation matching a given search criteria.
By default, only product availability and price is returned. To receive extended information use the extras parameter.

Note: It is mandatory to pass the input parameters: accommodation, booker, checkin, checkout and guest.

Security

BearerAuth

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/json

accommodationinteger, >= 1required

A signed integer number that uniquely identifies an accommodation property. The full list can be obtained by calling accommodations/details.

bookerobject(Booker)required

The booker's information.

checkinstring, (date)required

The checkin date. Must be within 500 days in the future and in the format yyyy-mm-dd.

checkoutstring, (date)required

The checkout date. Must be later than {checkin}. Must be between 1 and 90 days after {checkin}. Must be within 500 days in the future and in the format yyyy-mm-dd.

currencystring^[A-Z]{3}$

A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling common/payments/currencies.

Example:"EUR"

extrasArray of strings

Input parameter to request for additional information about this product.include_bundle_variants must be passed in order to retrieve all value added products.

Items Enum:"extra_charges""include_bundle_variants"

guestsobject(AccommodationsGuests)required

The guest details for the request.

paymentobject

Payment input information to filter results.

productsArray of strings

curl -i -X POST \
  https://demandapi.booking.com/3.1/accommodations/availability \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "accommodation": 10004,
    "booker": {
      "country": "nl",
      "platform": "desktop"
    },
    "checkin": "!START_DATE!",
    "checkout": "!END_DATE!",
    "extras": [
      "extra_charges"
    ],
    "guests": {
      "number_of_adults": 2,
      "number_of_rooms": 1
    }
  }'

Responses

Successful response.

Bodyapplication/json

request_idstring

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

dataobject(AccommodationsAvailabilityDataOutput)

Response

{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": {
    "id": 10004,
    "currency": "EUR",
    "deep_link_url": "booking://hotel/10004?affiliate_id=!AFFILIATE_ID!&checkin=!START_DATE!&checkout=!END_DATE!",
    "products": [ … ],
    "recommendation": { … },
    "url": "https://www.booking.com/hotel/nl/toren.html?aid=!AFFILIATE_ID!&checkin=!START_DATE!&checkout=!END_DATE!&no_rooms=1&group_adults=2"
  }
}