How can we help?
Follow
Search Hotels (Detail Level)

Overview

While making a search hotels request via the API, a mandatory field to include is DetailLevel.

The DetailLevel field is used to set the amount of details you will receive from the method HotelSearchRequest.

Possible Detail Levels

DetailLevel field in XML: Default, Low, Minimal, NoPackages, Meta, LowNoTax, MetaNoTax, NoPackagesNoTax, MetaExtended

DetailLevel field in JSON:

  • 0 = Default
  • 1 = Low
  • 2 = Minimal
  • 3 = NoPackages
  • 4 = Meta
  • 5 = LowNoTax
  • 7 = MetaNoTax
  • 8 = NoPackagesNoTax
  • 9 = MetaExtended

Using the first three DetailLevels, Default, Low, or Minimalgets all data in the search results, and by using these options, there is no need to call GetPackages. Doing this is unrecommended as it is very resource consuming and bandwidth-heavy, as all the packages show up in the search results.

Difference between the different detail levels

Click any of the detail levels in order to get the list of the tags that will be returned upon request.

Default

Default - Includes more detailed price breakdown, more package information, and full hotel information. Not Recommended because of the large response size. Will be blocked as from July 30, 2017, unless used in a single hotel ID context.

Breakdown of tags received:

  • Address
  • ChainCode
  • DefaultImage
  • FullSize
  • DisplayName
  • GeoLocation
  • Latitude
  • Longitude
  • ID
  • Packages
  • ContractId
  • HotelId
  • PackagePrice
  • Currency
  • FinalPrice
  • FinalPriceInSupplierCurrency
  • OriginalPrice
  • OriginalPriceInSupplierCurrency
  • SupplierCurrency
  • Refundability
  • Rooms
  • AdultsCount
  • Availability
  • Description
  • KidsAges
  • Price
  • RoomBasis
  • RoomBasisOriginal
  • RoomClass
  • RoomClassOriginal
  • RoomType
  • RoomTypeOriginal
  • SimplePrice
  • SupplierId
  • SupplierName
  • StarRating
Low

Low/LowNoTax - Includes less detailed price breakdown on the package including/excluding VAT (Tax) in the final/SimplePrice.
Please notice that by using this detail level, you won't be able to fetch room content.

Breakdown of tags received:

  • Address
  • ChainCode
  • DefaultImage
  • FullSize
  • DisplayName
  • GeoLocation
  • Latitude
  • Longitude
  • ID
  • Packages
  • Refundability
  • Rooms
  • AdultsCount
  • Availability
  • RoomBasis
  • RoomClass
  • RoomType
  • SimplePrice
  • SupplierName
  • StarRating
Minimal

Minimal - Same as Low, excluding the ChainCode and the supplier name of the package.

Breakdown of tags received:

  • Address
  • DefaultImage
  • FullSize
  • DisplayName
  • GeoLocation
  • Latitude
  • Longitude
  • ID
  • Packages
  • Refundability
  • Rooms
  • AdultsCount
  • Availability
  • RoomBasis
  • RoomClass
  • RoomType
  • SimplePrice
  • StarRating
No Packages

NoPackages /NoPackagesNoTax - Returns the minimum required hotel data.

Breakdown of tags received:

  • Address
  • DefaultImage
  • FullSize
  • DisplayName
  • GeoLocation
  • Latitude
  • Longitude
  • HighestPackagePrice
  • ID
  • LowestPackagePrice
  • StarRating
Meta

Meta/MetaNoTax  - Returns the minimum required hotel data.

Doesn't return any room information, only the lowest package price of each supplier per hotel, including/excluding VAT (Tax). 

This is a recommended practice!

Breakdown of tags received:

  • Address
  • DefaultImage
  • FullSize
  • DisplayName
  • GeoLocation
  • Latitude
  • Longitude
  • ID
  • StarRating
  • SuppliersLowestPackagePrices
  • Key
  • Value
Low No Tax

Low/LowNoTax - Includes less detailed price breakdown on the package including/excluding VAT (Tax) in the final/SimplePrice.

Breakdown of tags received:

  • Address
  • ChainCode
  • DefaultImage
  • FullSize
  • DisplayName
  • GeoLocation
  • Latitude
  • Longitude
  • ID
  • Packages
  • Refundability
  • Rooms
  • AdultsCount
  • Availability
  • RoomBasis
  • RoomClass
  • RoomType
  • SimplePrice
  • SupplierName
  • StarRating
Meta No Tax

Meta/MetaNoTax  - Returns the minimum required hotel data.

Doesn't return any room information, only the lowest package price of each supplier per hotel, including/excluding VAT (Tax). 

This is a recommended practice!

Breakdown of tags received:

  • Address
  • DefaultImage
  • FullSize
  • DisplayName
  • GeoLocation
  • Latitude
  • Longitude
  • ID
  • StarRating
  • SuppliersLowestPackagePrices
  • Key
  • Value
No Packages No Tax

NoPackages /NoPackagesNoTax - Returns the minimum required hotel data.

Breakdown of tags received:

  • Address
  • DefaultImage
  • FullSize
  • DisplayName
  • GeoLocation
  • Latitude
  • Longitude
  • HighestPackagePrice
  • ID
  • LowestPackagePrice
  • StarRating
MetaExtended

MetaExtended - Returns the minimum required hotel and room data, and cheapest rate per hotel including VAT (Tax).

See attached "MetaExtended" for more info and examples.

Breakdown of tags received:

  • AvailableBoards
  • HasFreeCancellationOption
  • ID
  • Packages
  • ContractId
  • HotelId
  • PackagePrice
  • Currency
  • FinalPrice
  • FinalPriceInSupplierCurrency
  • OriginalPrice
  • OriginalPriceInSupplierCurrency
  • SupplierCurrency
  • Refundability
  • Rooms
  • AdultsCount
  • Availability
  • Description
  • KidsAges
  • Price
  • RoomBasis
  • RoomBasisOriginal
  • RoomClass
  • RoomClassOriginal
  • RoomType
  • RoomTypeOriginal
  • SimplePrice
  • SupplierId
  • SupplierName
  • PaymentType
  • PropertyType
  • RoomsKeywords

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk