---
title: "List all bookable rooms at a property"
method: GET
path: "/demand-api-v2-compatible/blockAvailability"
tags: ["demand-api-v2-compatible"]
---

# List all bookable rooms at a property

`GET /demand-api-v2-compatible/blockAvailability`

This endpoint is where you find a list of all bookable or available rooms at a property.
A room can have multiple blocks, as a block is a combination of the meal, cancellation policy, occupancy and other things.
You can find detailed information about one hotel per search (detail_level)
which will return most of the information needed to replicate the booking.com property page.

If you want to search multiple hotels, you can, but you get less detail.
For searching multiple hotels, it is recommended to use hotelAvailability.

## Query parameters

- `blockInput` BlockAvailabilityInputDto, required
  - `hotel_ids` integer[], required — Hotel ID(s) to check availability for.
  - `checkin` string, date, required — The arrival date.
  - `checkout` string, date, required — The departure date. Must be later than {checkin}.
  - `guest_cc` string, required — Guest country code. Used to accurately display the best prices and price details for people from that country.
  - `currency` string — Returns the prices in this currency, in addition to the hotel currency.
  - `extras` string[] — The extra items for this request. See the documentation for more details about each extra.
  - `affiliate_id` string — Application affiliate id
  - `block_ids` string[] — Return only availability hits with these particular block IDs
  - `guest_ip` string — Guest IP address for determining guest country and showing the best price for that user and obeying laws regarding the display of taxes and fees.
  - `guest_qty` integer[] — Number of guests for which blocks will be found. The total number of guests is used for calculating city tax charges. It is specified as an array of guest numbers. If you use this parameter and make bookings through the API, you should also set the exact same value in the guest_quantities parameter for the processBooking call, otherwise per-person included charges may result in pricing problems, causing the booking to fail. NOTE: After version 2.6 either this or `room1` needs to be provided.
  - `language` 'ar' | 'bg' | 'ca' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'en-gb' | 'en-us' | 'es' | 'es-ar' | 'es-mx' | 'et' | 'fi' | 'fr' | 'he' | 'hi' | 'hr' | 'hu' | 'id' | 'is' | 'it' | 'ja' | 'ka' | 'ko' | 'lt' | 'lv' | 'ms' | 'nl' | 'no' | 'pl' | 'pt-br' | 'pt-pt' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sr' | 'sv' | 'th' | 'tl' | 'tr' | 'uk' | 'vi' | 'zh' | 'zh-cn' | 'zh-tw' — Specify the language for: block_id, policies, room texts and hotel descriptions. Note: not all text is translated in all languages. Please check the "Possible Values" section of the documentation for the accepted language codes.
  - `num_rooms` integer — Takes a number of rooms to put guests into
  - `room1` string[] — Which guests to put in which rooms. Syntax: comma-separated list, `A` for each adult, a number in the range 0..17 for each child.
  - `user_platform` 'ANDROID' | 'DESKTOP' | 'IOS' | 'MOBILE' | 'TABLET' — The user's platform.

## Headers

- `Accept` 'application/json, application/xml'

## Response `200`

OK

- ResponseOutputV2BlockAvailabilityOutputDto
  - `meta` Meta
    - `ruid` string
  - `result` BlockAvailabilityOutputDto[]
    - `block` BlockOutputDto[] — The object containing all the relevant information for the combination of room, policy, meal and occupancy that determines the price." A block is the unique entity you book with booking.com.
      - `block_id` string
      - `breakfast_included` boolean
    - `can_pay_now` boolean — Boolean value set to "true" if payment can be made during reservation process or "false" if it can not.
    - `checkin` string — The date that was searched for as checkin. Format: YYYY-MM-DD
    - `checkout` string — The date that was searched for as checkout. Format: YYYY-MM-DD
    - `direct_payment` boolean — Boolean value set to "true" if the direct payment is available or "false" if it is not.
    - `hotel_id` integer — Booking.com hotel ID. The unique identifier of this hotel.
    - `hotel_url` string — URL of the hotel's page on Booking.com.
    - `isFlashDeal` boolean
    - `flash_deal` boolean

## Other responses

- `400` — Invalid input, e.g. a missing, invalid, unknown, or conflicting parameter.
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.net/booking/apis/connect-api.md) · [All operations](https://skmtc.net/booking/apis/connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/connect-api/revisions/0fbdc2f4423a/schema)