Search Hotels - Detail Levels

The DetailLevel field is used to set the amount of details you will receive from Hotels Search request.
The different detail levels are :

JSON ValueXML Value
1Low
2Minimal
3NoPackages
4Meta
5LowNoTax
6MetaAdvanced
7MetaNoTax
8NoPackagesNoTax
9MetaExtended

Using the first three DetailLevels, Default, Low, or Minimal, gets 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.

Feel free to try the different detail levels and see what works best for your specific situation and users, however, if you just want to get started, we recommend using "MetaExtended", as it is lightweight and returns all of the commonly needed fields.


Detail Levels - Breakdown :

0️⃣

Default (0) -

Includes more detailed price breakdown, more package information, and full hotel information. Not Recommended because of the large response size.
Can be used only with a single hotel ID .

Breakdown of tags received :

  • Address
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocation (Long + Lat)
  • HotelID
  • Packages
    • ContractId
    • HotelId
  • PackagePrice
    • Currency
    • FinalPrice
    • FinalPriceInSupplierCurrency
    • OriginalPrice
    • OriginalPriceInSupplierCurrency
    • SupplierCurrency
  • Rooms
    • SupplierId
    • SupplierName

1️⃣

Low (1) -

Includes less detailed price breakdown on the package, Simple (final) Price including VAT (Tax).
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 (Long + Lat)
  • HotelID
  • CityTax
  • PackageID
  • Refundability
  • Rooms
    • AdultsCount
    • Availability
    • RoomBasis
    • RoomClass
    • RoomType
    • SpecialDeals
  • SRSP
  • SimplePrice
  • Supplier name
  • StarRating

2️⃣

Minimal (2) -

Same as Low, excluding the the supplier name of the package.

Breakdown of tags received:

  • Address
  • DefaultImage
  • FullSize
  • DisplayName
  • GeoLocation (Long + Lat)
  • HotelID
  • Packages
    • Refundability
    • Rooms
    • AdultsCount
    • Availability
    • RoomBasis
    • RoomClass
    • RoomType
  • SimplePrice
  • StarRating

3️⃣

NoPackages (3) -

Returns the minimum required hotel data.

Doesn't return any room information, only the lowest package price and highest package price per hotel, lowest and highest price including VAT (Tax).

Breakdown of tags received:

  • Address
  • CityTax
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocation (Long + Lat)
  • HighestPackagePrice
  • HotelID
  • LowestPackagePrice
  • StarRating

4️⃣

Meta (4) -

Returns the minimum required hotel data.

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

Breakdown of tags received:

  • Address
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocation (Long + Lat)
  • HotelID
  • StarRating
  • SuppliersLowestPackagePrices
    • Supplier short name (Key)
    • Price including Tax (Value)

5️⃣

LowNoTax (5) -

Includes less detailed price breakdown on the package, Simple (final) Price excluding VAT (Tax).
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 (Long + Lat)
  • HotelID
  • PackageID
    • Refundability
  • Rooms
    • AdultsCount
    • Availability
    • RoomBasis
    • RoomClass
    • RoomType
  • SRSP
  • SimplePrice
  • Supplier short name
  • StarRating

6️⃣

MetaAdvanced (6) -

Returns the recommended required hotel data.

Breakdown of tags received:

  • Address
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocations (Long + Lat)
  • HotelID
  • Price
  • SupplierName
  • StarRating
  • Reviews

7️⃣

MetaNoTax (7) -

Returns the minimum required hotel data.

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

Breakdown of tags received:

  • Address
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocation (Long + Lat)
  • HotelID
  • StarRating
  • SuppliersLowestPackagePrices
    • Supplier short name (Key)
    • Lowest supplier price (Value)

8️⃣

NoPackagesNoTax (8) -

Returns the minimum required hotel data.

Doesn't return any room information, only the lowest package price and highest package price per hotel, lowest and highest price excluding VAT (Tax).

Breakdown of tags received:

  • Address
  • DefaultImage (FullSize)
  • CityTax
  • DisplayName
  • GeoLocation (Long + Lat)
  • HighestPackagePrice
  • HotelID
  • LowestPackagePrice
  • StarRating

9️⃣

MetaExtended (9) -

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

Breakdown of tags received:

  • AvailableBoards
  • HasFreeCancellationOption
  • HotelID
  • Packages
    • ContractId
    • HotelId
    • PackagePrice
    • Currency
    • FinalPrice
    • FinalPriceInSupplierCurrency
    • OriginalPrice
    • OriginalPriceInSupplierCurrency
    • SupplierCurrency
  • Refundability
  • Rooms
    • AdultsCount
    • Availability
    • Description
    • KidsAges
    • Price
    • SimplePrice
  • SupplierId
  • SupplierName
  • PaymentType
  • PropertyType
  • RoomsKeywords