---
title: "Hotels Information"
method: GET
path: "/content-api/hotels"
tags: ["hotel"]
---

# Hotels Information

`GET /content-api/hotels`

Returns static information about hotels including photos, rooms, amenities, etc.

## Query parameters

- `ids` string, required
- `language` 'EN' | 'ES' | 'PT' | 'EN,PT,ES' | 'EN,ES' | 'ES,PT' | 'EN,PT'

## Response `200`

Successful response

- object[]
  - `id` string — hotel id
  - `property_type` string — should indicate the property type (hotel for accommodations)
  - `product` 'HOTEL' | 'VACATION_RENTAL' — Possible values for this ID are:
  - `merged_from_ids` unknown[] — this structure contains a list with all the ids of the same accommodation that were merged in the past
    - unknown
  - `published` boolean — If False, it will not be available in the booking flow.
  - `name` string — hotel name
  - `hotel_type` object — structure that contains id and description (in desired languages) of the accommodation type
    - `id` 'YTH' | 'HOT' | 'EST' | 'INN' | 'MOT' | 'ECO' | 'CFL' | 'BAB' | 'VIL' | 'HTA' | 'LHO' | 'HSR' | 'APT' | 'CAR' | 'FML' | 'GLA' | 'CAS' | 'BTQ' | 'LDG' | 'DPT' | 'RSR' | 'ALT' | 'ALQ' | 'HST' | 'RES' | 'POS' | 'CAM' | 'CAB' | 'SUI' — Possible values for this ID are:
    - `description` object
    - `name` object
      - `singular` object
      - `plural` object
  - `stars` integer — star rating
  - `location` object — structure with geo information about the hotel location
    - `city` object
      - `id` integer
    - `address` string
    - `zipcode` integer
    - `latitude` number
    - `longitude` number
    - `neighborhoods` unknown[]
      - unknown
  - `checkin` object — time available for checkin (from - to hours)
    - `from` string
    - `to` string
  - `checkout` object — time available for checkout (from - to hours)
    - `to` string
  - `information` object — structure with a language - text pairs regarding information about the hotel
    - `en` string
  - `notices` object — structure with a language - text pairs regarding information about particularities about the accommodation. Example: Reception working hours, possible charges to pay/deposits needed when arriving, documentation required by the hotel, among others.
    - `en` string
  - `creation_date` string, date — datetime field that indicates the date when the hotel listing was created
  - `last_modified_date` string, date — datetime field that indicates the max date when the hotel listing suffered any changes or updates
  - `main_picture` object — structure with url and information about the main picture of the hotel
    - `url` string
    - `id` string
    - `width` integer
    - `height` integer
    - `picture_category` object
      - `id` integer
      - `description` object
        - `en` string
    - `picture_categories` object
      - `id` integer
      - `description` object
        - `en` string
  - `number_of_rooms` integer — number of rooms the accommodation has
  - `pictures` object[] — list structure with url and description for each picture
    - `url` string
    - `id` string
    - `width` integer
    - `height` integer
    - `picture_category` object
      - `id` integer
      - `description` string
    - `picture_categories` object
      - `id` integer
      - `description` string
  - `extra_details` object — structure with extra information (e.g.: phone numbers)
    - `hotel_brand` object
      - `id` number
      - `name` string
      - `hotel_chain` object
        - `id` number
        - `name` number
    - `phone_numbers` unknown[]
      - unknown
    - `completeness` number
    - `email` string
    - `breakfast_time` object
      - `from` string, time
      - `to` string, time
  - `rating` integer
  - `room_types` object[] — structure with room information
    - `id` integer
    - `internal_name` string
    - `despegar_names` object
    - `information` object
      - `en` string
    - `room_distribution` object
      - `id` string
      - `descriptions` object
    - `room_category` object
      - `id` string
      - `descriptions` object
    - `amenities` object[]
      - `id` string
      - `descriptions` object
        - `en` string
      - `amenity_category` object
        - `id` string
        - `icon` string
        - `descriptions` object
          - `en` string
    - `room_view` object
      - `id` string
      - `descriptions` object
    - `smoking_option` object — A room can have three possible configurations in terms of the smoking policy.
      - `id` string — NSM or NDS or SMK
      - `descriptions` object
        - `en` string — NSM: Not allowed / NDS: Unknown / SMK: Allowed
    - `shared_bathroom` boolean
    - `room_size` integer
    - `room_size_unit` string
    - `max_occupancy` number
    - `pictures` object[]
      - `url` string
      - `id` string
      - `width` number
      - `height` number
      - `picture_category` object
        - `id` number
        - `descriptions` object
          - `en` string
    - `creation_date` string, date
    - `last_modified_date` string, date
  - `categorized_notices` object — structure with notices information grouped by in different labels
    - `primary` object
      - `title` object
      - `notices` object[]
        - `title` object
        - `messages` unknown[]
          - unknown
    - `secondary` object
      - `title` object
      - `notices` object[]
        - `title` object
        - `messages` unknown[]
          - unknown
  - `amenities` object[]
    - `id` string
    - `description` object
    - `amenity_category` object
      - `id` string
      - `icon` string
      - `description` object
  - `special_requests` object[]
    - `id` string
    - `description` object
    - `enabled` boolean
  - `fees` object[]
    - `currency` string
    - `amount` number
    - `fee_type` object
      - `id` string
      - `descriptions` object
    - `fee_application_scope` object
      - `id` string
      - `descriptions` object
      - `fee_amount_type` object
        - `id` string
        - `descriptions` object
  - `spoken_languages` object[]
    - `id` string
    - `description` object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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