---
title: "Detail"
method: GET
path: "/hotels-api/availability/{hotel_id}"
tags: ["Availability"]
---

# Detail

`GET /hotels-api/availability/{hotel_id}`

Returns live availability for a specific hotel.

## Path parameters

- `hotel_id` string, required

## Query parameters

- `country_code` string
- `checkin_date` string, date, required
- `checkout_date` string, date, required
- `currency` string, required
- `distribution` string, required
- `roompack_id` string
- `language` 'EN' | 'ES' | 'PT'
- `ttl` integer
- `refundable_only` boolean

## Response `200`

Detailed availability for the hotel

- object
  - `id` integer
  - `hotel_info` object — This structure is of type dictionary and returns hotel information.
    - `type` string
  - `roompacks` object[]
    - `id` string — roompack id
    - `meal_plan` object — Meal plan corresponding to the roompack (e.g., room only, breakfast included, all-inclusive, etc.).
      - `id` string
    - `price_detail` object
      - `currency` string — currency in which values will be expressed
      - `total` number — total value of the roompack (subtotal + taxes). It does not include charges to be paid at destination
      - `taxes` number — taxes corresponding to the roompack price
      - `taxes_detail` object[] — list with code and amount pairs
        - `code` string
        - `amount` string
      - `binding_public_rate_enabled` boolean — if set to true, “amount” value is the mínimum price that the partner should sell the item
      - `binding_public_rate_value` integer
      - `agency_commission` object — Applicable only to commissionable models.
        - `amount` number
        - `percentage` number
      - `charge_at_destination` number
      - `charge_at_destination_detail` object[]
        - `code` string
        - `amount` number
    - `cancellation_policy` object — This structure is of type list and can return one or several rules regarding cancellation policies of the roompack
      - `status` 'non_refundable' | 'partially_refundable' | 'fully_refundable' — Represents the cancellation policy status at the moment the request is made
      - `hours_before_penalty` integer — hours prior to check in which status applies in case of cancelling in those conditions
      - `vendor_notes` string — string field with information regarding cancellation policies.
      - `cancellation_policy_rules` object[] — This structure is of type list and can return one or several rules regarding cancellation policies of the roompack. The penalty may be applied per night or as a percentage. Based on the information provided by the partner, the refund amount is determined. If no penalty is specified for that range, it is considered that no penalty applies.
        - `type` string — rule type
        - `penalty` object — contains the percentage of the total amount of the reservation that should be considered as charge in case of cancelling in theses conditions
          - `percentage` number
          - `night_count` number
        - `anticipation` object — timeframe where the rules apply. it is a dictionary with “from” and “to” values measured in hours to check in.
          - `from` integer
          - `to` integer
    - `rooms` object[]
      - `name` string — room name
      - `reference` integer — index of room elements contained in the roompack choice (first index == 1)
      - `room_type_id` string — room id.These id should be used to map static content about the room
      - `bed_options` object[] — list with all bedding options for the room
        - `id` integer
        - `description` string
      - `max_capacity` integer — maximum pax capacity of the room
      - `choice_id` string — id to be used for prebook stage
    - `promo` object
      - `type` string
      - `saving` object — Details of the promotional savings associated with the product.
        - `type` string
        - `percentage` number
    - `tags` unknown[] — Used to identify products associated with a promotion.
      - unknown
  - `categorized_notices` object — Main container for categorized hotel notices, organized by importance level
    - `primary` object — PRIMARY notices category - Critical and priority information that guests must know obligatorily
      - `title` object
        - `en` string — This field is dynamically returned according to the language specified in the request
      - `notices` object[] — Array of individual notices within the primary category
        - `title` object
          - `en` string — This field is dynamically returned according to the language specified in the request
        - `messages` object[] — This field is dynamically returned according to the language specified in the request
          - `en` string
    - `secondary` object — SECONDARY notices category - Important but lower priority information, policies and operational details
      - `title` object
        - `en` string
      - `notices` object[] — Array of individual notices within the primary category
        - `title` object
          - `en` string
        - `messages` object[] — This field is dynamically returned according to the language specified in the request
          - `en` string

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