---
title: "Availability"
method: GET
path: "/hotels-api/availability"
tags: ["HotelAvailability"]
---

# Availability

`GET /hotels-api/availability`

## Request

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

Search for available hotels based on input criteria.

## Query parameters

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

## Response `200`

Availability response

- object
  - `items` object[]
    - `id` string: hotel id
    - `hotel_info` object: This structure is of type dictionary and returns hotel information.
      - `name` string: hotel name
      - `type` string
      - `stars` integer: star rating
      - `location` object: an object that contains latitude and longitude values for the hotel location
        - `latitude` number
        - `longitude` number
    - `roompacks` object[]
      - `id` string
      - `meal_plan` object: Meal plan corresponding to the roompack (e.g., room only, breakfast included, all-inclusive, etc.).
        - `id` string
      - `rooms` object[]
        - `name` string: room name
        - `reference` integer: index of room elements contained in the roompack choice (first index == 1)
        - `bed_options` string[]: list with all bedding options for the room
        - `room_type_id` string: room id. These id should be used to map static content about the room
        - `max_capacity` integer: maximum pax capacity of the room
      - `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
        - `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` integer
          - `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
      - `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` number
        - `agency_commission` object: Applicable only to commissionable models.
          - `amount` number
          - `percentage` number
        - `charge_at_destination` number
        - `charge_at_destination_detail` object[]
          - `code` 'TT: Turism fee' | 'TA: Additional fee' | 'RF: Resort fee' | 'TM: Bellboy fee' | 'EF: Environmental fee' | 'DO: Damage deposit (refundable)' | 'TL: Cleaning fee' | 'DS: Security deposit' | 'ISS: Tax over service' | 'TS: Service charge' | 'TE: Energy fee' | 'CT: City Tax' | 'SH: Hotel insurance': This field can have different possible values, which are:
          - `amount` string
        - `taxes_at_destination` number: Refers to taxes to be paid at the propery (e.g VAT)
        - `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` number
      - `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
  - `paging` object: Pagination details for the response.
    - `offset` integer: Number of results skipped.
    - `limit` integer: Maximum number of results returned per page.
    - `total` integer: Total number of results available.
  - `sorting` object: Sorting options available for the result set.
    - `criteria` string: Sorting method applied.
    - `values` object[]: List of available sorting options.
      - `value` string: Sorting option identifier.
      - `selected` boolean: Whether this sorting option is currently applied.

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