---
title: "Initial request for searching hotels"
method: POST
path: "/api/hotel/availability/init"
tags: ["Hotel"]
---

# Initial request for searching hotels

`POST /api/hotel/availability/init`

Initial request for searching hotels

## Headers

- `accountId` string, required
- `apiKey` string, required

## Request body

- HotelAPIDataContractAvailabilityRequestAvailabilityInitRq — AvailabilityInitRq
  - `channelId` string, required — A unique identifier that is generated during setup. It is used to identify the source of the request and apply the appropriate business configurations.
  - `currency` string, required — Used to define the currency in which the rates should be returned. If not specified, the default currency configured on the channel will be used.
  - `culture` string, nullable
  - `checkIn` string, date-time, required — Check-in date.
  - `checkOut` string, date-time, required — Check-out date.
  - `occupancies` HotelAPIDataContractCommonOccupancy[], required — Specify the occupancy details for each room requested. For a multi-room request, each room's occupancy should be specified separately.
    - `numOfAdults` integer, required — Identifies the number of adult guests in the room.
    - `childAges` integer[], nullable — Ages of the children in the room. The number of items in the array will calculate the child count.
  - `circularRegion` HotelAPIDataContractAvailabilityRequestCircularRegion
    - `centerLat` number, double, required — Center latitude for the circular based search.
    - `centerLong` number, double, required — Center longitude for the circular based search.
    - `radiusInKM` integer, required — Radius in km for forming circular boundary for circular search taking centerLat and centerLong as point of reference.
  - `polygonalRegion` HotelAPIDataContractAvailabilityRequestPolygonalRegion
    - `coordinates` HotelAPIDataContractCommonGeoCode[], required — Geo Coordinates
      - `lat` number, double, required — Latitude
      - `long` number, double, required — Longitude
  - `multiPolygonalRegion` HotelAPIDataContractAvailabilityRequestMultiPolygonalRegion
    - `polygons` HotelAPIDataContractAvailabilityRequestPolygonalRegion[], nullable
      - `coordinates` HotelAPIDataContractCommonGeoCode[], required — Geo Coordinates
        - `lat` number, double, required — Latitude
        - `long` number, double, required — Longitude
  - `hotelIds` string[], nullable — Unica hotelIds
  - `nationality` string, nullable — Used to identify the primary guest's nationality. This information might be used to fetch nationality-based rates from the provider/hotels. Format: 2-character ISO country code.
  - `countryOfResidence` string, nullable — Used to identify the primary guest's nationality. This information might be used to fetch nationality-based rates from the provider/hotels. Format: 2-character ISO country code.
  - `destinationCountryCode` string, nullable — Country code of the destination. Format: 2-character ISO country code.
  - `filterBy` HotelAPIDataContractAvailabilityRequestFilterBy
    - `ratings` HotelAPIDataContractCommonRange
      - `min` integer
      - `max` integer
    - `facilities` string[], nullable
    - `location` HotelAPIDataContractCommonLocation
      - `state` string, nullable
      - `country` string, nullable
  - `additionalInformation` HotelAPIDataContractAvailabilityRequestAdditionalInformation[], nullable — Additional information.
    - `type` string, nullable
    - `text` string, nullable
  - `providerFilter` HotelAPIDataContractCommonProviderFilter
    - `providerIds` string[], nullable
    - `inclusion` boolean, nullable
  - `userInfo` HotelAPIDataContractAvailabilityRequestUser
    - `email` string, nullable
    - `role` string, nullable
    - `agencyId` string, nullable
  - `travelPurpose` 'Leisure' | 'Business'

## Response `200`

Success

- HotelAPIContractAvailabilityInitRS
  - `token` string, nullable — Unique token to be used throught the process from search to book for a complete transaction.

## Other responses

- `100` — Continue
- `400` — ClientSideError

---

[API](https://skmtc.net/zentrumhub/apis/hotelcontent-api.md) · [All operations](https://skmtc.net/zentrumhub/apis/hotelcontent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zentrumhub/hotelcontent-api/revisions/9fa4830db488/schema)