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

# Detail

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

## Request

- Base URL: `https://api-dev.despegar.com/v3`
- URL: `https://api-dev.despegar.com/v3/hotels-api/availability/{hotel_id}`
- Auth: API key in header `x-apikey`

Returns live availability for a specific hotel.

## Path parameters

- `hotel_id` string, required

## Query parameters

- `country_code` string, required
- `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
      - `taxes_at_destination` number: Refers to taxes to be paid at the propery (e.g VAT)
    - `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.dev/despegar/apis/hotels.md) - [All operations](https://skmtc.dev/despegar/apis/hotels/llms.txt) - [OpenAPI document](https://skmtc.dev/despegar/apis/hotels/revisions/2d05063d9e85?raw)