---
title: "GET /api/hotel/availability/async/{token}/results"
method: GET
path: "/api/hotel/availability/async/{token}/results"
tags: ["Hotel"]
---

# GET /api/hotel/availability/async/{token}/results

`GET /api/hotel/availability/async/{token}/results`

## Path parameters

- `token` string, required

## Query parameters

- `nextResultsKey` string

## Headers

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

## Response `200`

Success

- HotelAPIDataContractAvailabilityResponseAvailabilityAsyncRS
  - `token` string, nullable — Unique token recieved in the search init response to be used throught the process from search to book for a complete transaction.
  - `nextResultsKey` string, nullable — Next result key to be used to fetch the next set of results
  - `status` 'InProgress' | 'Completed'
  - `expectedHotelCount` integer — This indicates the number of hotels that has been requested for a particular search.
  - `completedHotelCount` integer — This indicates the number of hotels for which the rates have been fetched.
  - `currency` string, nullable — The currency details for the hotel rates.
  - `hotels` HotelAPIDataContractAvailabilityResponseHotelAsync[], nullable — List of hotels
    - `id` string, nullable — UnicaId of the hotel.
    - `relevanceScore` integer
    - `rate` HotelAPIDataContractAvailabilityResponseHotelRate
      - `totalRate` number, double — Total rate of the hotel inclusive of taxes.
      - `publishedRate` number, double — Publish rate provided by the hotel.
      - `baseRate` number, double — Base rate of the hotel exclusive of taxes.
      - `commission` number, double — Commission amount detail provided by the source.
      - `taxes` number, double — Tax amount provided by the source.
      - `fees` number, double — Fee amount provided by the source.
      - `discounts` number, double — Discount amount provided by the source.
      - `providerId` string, nullable — Provider/Supplier Identifier for the Rate
      - `providerName` string, nullable — Provider/Supplier Name for the Rate
      - `offer` HotelAPIDataContractCommonOffer
        - `title` string, nullable
        - `description` string, nullable
        - `type` 'FixedDiscount' | 'PercentageDiscount' | 'StayOffer'
        - `discountOffer` number, double, nullable
        - `percentageDiscountOffer` integer, nullable
        - `stayOffer` HotelAPIDataContractCommonStayOffer
          - `stayNights` integer
          - `freeNights` integer
      - `distributionType` 'Unknown' | 'Public' | 'Private' | 'MinimumSellingPrice' | 'Optimized' | 'Corporate'
      - `distributionChannel` 'Any' | 'Website' | 'AgentTool' | 'Mobile' | 'MetaSearch' | 'Cache'
      - `type` 'Published' | 'Negotiated'
      - `publishedRateProviderId` string, nullable — Provider/Supplier Identifier for the PublishedRate
      - `publishedRateProviderName` string, nullable — Provider/Supplier Name for the PublishedRate
      - `payAtHotel` boolean, nullable — Indicates whether the payment for the booking will be made directly at the hotel.
      - `additionalCharges` HotelAPIDataContractCommonAdditionalCharge[], nullable — Provides information about any additional rate component that is part of the total rate.
        - `charge` HotelAPIDataContractCommonCharge
          - `type` 'Fee' | 'Tax' | 'ResortFee' | 'Unknown'
          - `description` string, nullable
          - `frequency` 'PerNight' | 'PerStay' | 'PerWeek' | 'Unknown'
          - `unit` 'PerPerson' | 'PerRoom' | 'PerAcommodation' | 'PerAdult' | 'Unknown'
          - `amount` number, double
          - `currency` string, nullable
        - `text` string, nullable
      - `otherRateComponents` HotelAPIDataContractCommonRateComponent[], nullable
        - `amount` number, double
        - `description` string, nullable
        - `type` string, nullable
        - `isIncludedInBaseRate` boolean
      - `supplierBookingPaymentDate` string, nullable
      - `publishedBaseRate` number, double — Publish baseRate provided by the hotel.
      - `rateIdentifier` string, nullable
      - `cancellationPolicy` HotelAPIDataContractCommonCancellationPolicy[], nullable — Cancellation policy details provided by the source.
        - `text` string, nullable
        - `rules` HotelAPIDataContractCommonRule[], nullable
          - `value` number, double
          - `valueType` 'Amount' | 'Percentage' | 'Nights'
          - `estimatedValue` number, double
          - `start` string, date-time
          - `end` string, date-time
      - `additionalInformation` HotelAPIDataContractCommonAdditionalInformation[], nullable — Additional information.
        - `type` string, nullable
        - `text` string, nullable
      - `isChildConvertedToAdult` boolean — Indicates whether any child pax provided in the search request is being treated as adult on the supplier end.
    - `isNewInResult` boolean — This indicates whether we have received this hotel for the first time in the result set.
    - `moreRatesExpected` boolean — This indicates if more rates are still being fetch for a search call.
    - `isRecommended` boolean, nullable
    - `options` HotelAPIDataContractAvailabilityResponseHotelOptions
      - `freeBreakfast` boolean, nullable
      - `freeCancellation` boolean, nullable
      - `refundable` boolean, nullable
      - `payAtHotel` boolean, nullable
      - `contractedRateExists` boolean, nullable
      - `roomOnly` boolean, nullable
      - `halfBoard` boolean, nullable
      - `fullBoard` boolean, nullable
      - `isGstMandatory` boolean, nullable
      - `isPANMandatory` boolean, nullable
      - `allInclusive` boolean, nullable
      - `isPrivateDistribution` boolean, nullable
      - `isPublicDistribution` boolean, nullable
      - `isOptimizedDistribution` boolean, nullable
      - `isCorporateDistribution` boolean, nullable
    - `additionalInformation` HotelAPIDataContractCommonAdditionalInformation[], nullable — This provides miscellanious information about the hotel rates.
      - `type` string, nullable
      - `text` string, nullable

## Other responses

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