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

# Search

`GET /hotels-api/availability`

Search for available hotels based on input criteria.

## Query parameters

- `country_code` string
- `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

## 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
        - `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
        - `agency_commission` object — Applicable only to commissionable models.
          - `amount` number
          - `percentage` number
        - `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

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