---
title: "Get details of accommodations"
method: GET
path: "/demand-api-v2-compatible/hotels"
tags: ["demand-api-v2-compatible"]
---

# Get details of accommodations

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

This call returns the hotel and room data. By default, only hotel_id is returned in the output.

One of the argument: hotel_ids, city_ids, country_ids, region_ids, district_ids, chain_ids is mandatory.

Additional data needs to be requested via extras parameter.

The data is returned in English by default.

## Query parameters

- `hotelsInput` HotelsInputDto, required
  - `hotel_ids` integer[] — A list of up to 1000 hotel ids.
  - `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' — The language code to return the results in. Please check the "Possible Values" section of the documentation for the accepted language codes.
  - `extras` string[] — Returns extra bits of information about hotels.
  - `offset` integer — The number of rows to offset the results by. NOTE: this needs to be 0 or a multiple of 100.
  - `rows` integer — The maximum number of rows to return. NOTE: this needs to be a multiple of 100.

## Headers

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

## Response `200`

OK

- ResponseOutputV2HotelsOutputDto
  - `meta` Meta
    - `ruid` string
  - `result` HotelsOutputDto[]
    - `hotel_data` HotelDataDto — Hotel specific information.
      - `address` string — The street address of the hotel.
      - `city_id` integer — Id of the city where this property is located.
      - `country` string — Two-letter ISO country code of the hotel.
      - `location` CoordinatesDto — A signed integer number that uniquely identifies a city.
        - `latitude` number, double — Latitude.
        - `longitude` number, double — Longitude.
      - `zip` string — Hotel ZIP code
      - `currency` string — Three-letter ISO currency code for the hotel.
      - `checkin_checkout_times` CheckinCheckoutTimesDto
        - `checkin_from` LocalTime — The time till when checkout can be done at this property.
          - `hour` integer
          - `minute` integer
          - `second` integer
          - `nano` integer
        - `checkin_to` LocalTime — The time till when checkout can be done at this property.
          - `hour` integer
          - `minute` integer
          - `second` integer
          - `nano` integer
        - `checkout_from` LocalTime — The time till when checkout can be done at this property.
          - `hour` integer
          - `minute` integer
          - `second` integer
          - `nano` integer
        - `checkout_to` LocalTime — The time till when checkout can be done at this property.
          - `hour` integer
          - `minute` integer
          - `second` integer
          - `nano` integer
      - `hotel_photos` HotelPhotoDto[] — Photos specific information of the hotel.
        - `main_photo` boolean — Is this the main hotel photo.
        - `url_original` string — Url of the photo with max width of 500 pixels.
      - `hotel_description` string — The description text for this hotel.
      - `url` string — URL of the hotel's page on Booking.com.
      - `deep_link_url` string — Deep link mobile app URL.
      - `region_ids` integer[] — List of region_ids that the hotel belongs to
      - `number_of_reviews` integer — Number of reviews for this hotel.
      - `review_score` number, double — Review score of this hotel.
      - `spoken_languages` string[] — Languages spoken by the hotel's staff
    - `hotel_id` integer — Unique ID to represent this hotel.
    - `room_data` RoomDataDto[] — This block has room data for this hotel.
      - `room_id` integer
      - `room_info` RoomInfoDto
        - `bathroom_count` number, double
        - `bedroom_count` number, double
        - `bedrooms` BedroomDto[]
          - `bed_configurations` BedConfigurationDto[]
            - `id` string — Uniquely identifies this bed configuration.
            - `configuration` BedDto[] — Detail list of all different types and number of beds included in this configuration.
              - …
        - `occupancy` RoomOccupancyDto
          - `allow_cribs_and_extra_beds` boolean
          - `max_adults` integer
          - `max_children` integer
          - `max_cribs` integer
          - `max_extra_beds` integer
          - `max_occupancy` integer
        - `room_size` RoomSizeDto
          - `metre_square` number, double
        - `room_type_id` integer

## 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)