Our new API Documentation & Developer HUB - Link .

** In case you want to login and search at the same request (without separated login request).

Recommended!

UserName 

Password

Will be provided by Travolutionary support team upon set-up, or by creating a new user in the B2B/ Back-office system.

Mandatory. Lead pax residency, ISO Country Code (Example: US, CZ, IL).

Required by some of the suppliers, as they have special/restricted rates according to the residency value we passed them.

You can pass a value on the request, to override the default timeout value which was defined for the user (On the B2B, under 'User Settings' section). The system will wait and not return results until the timeout value reached or until all suppliers returned results.

Mandatory:

Default - More info

Low/LowNoTax - More info

Minimal NoPackages /NoPackagesNoTax - More info

Meta/MetaNoTax  - More info

MetaExtended - More info

This field is to be included in the search request in case you are working with the static data file and do not need the hotel details to be returned, but only the hotel id.

For best performance, use true (Not recommended for MetaExtended).
False - include all hotel details in the response (Address, ChainCode, DisplayName, GeoLocation, StarRating, TrustYou - If authorized).
True - exclude all hotel details in the response except the hotel id and default image.

* Up to 3000 hotel IDs per request.

Note: This is the less recommended search method. Best to use either HotelIds or GetLocation based search.

----Can not be used when searching by Geo-----

* Search by hotel location. List of location ids can be downloaded here.

***NOT IN USE***

False - default value.
True - might be useful for some USA cities.

Radius from Lat/Lang coordinates to search in.

*Mandatory* when using GeoLocation search. Cannot be "NULL" or "0" or greater than "75,000"!

Mandatory. Number of guests to stay in a room. Up to 8 in a room. Cannot be “0” or “NULL”!

* BackOffice: The total number of passengers (adults + children) per room is 4.

Note that most suppliers support up to 4 guests per room, while only some suppliers support more than 4 guests per room.

Up to 4 rooms in a request.

* API: Using our API allows up to 8 adults and no limit on the number of children or adults/children combination.

Note that while we don't have a limit, the suppliers are unlikely to return results to high amount of children/adults combination in 1 room.

***NOT IN USE***

False - default value. No separate beds in the room.
True - Separated beds.

 Hotel Address

RoomsPackage:

1. ContractId - Contract with supplier

2. HotelId - From our Static Data Content

3. PackageId - Unique ID stores Package details. When no package id is returned (Supplier didn't provide any room information on his search response), you need to call HotelsSupplierDetails Request to obtain the package ids and full room information.

4. PackagePrice:

4.A. Currency - searched currency

4.B. FinalPrice - Represents the Booking/Selling Price in the searched currency including any pricing rules that were applied.

4.C FinalTax - Tax in the searched currency.

* Will be returned if the supplier returned Tax info in his response, or if FakeTax feature is enabled.

4.D. FinalPriceInSupplierCurrency

4.E. OriginalPrice - the original price that has been delivered from the parent node

4.F. OriginalPriceInSupplierCurrency

4.H. SupplierCurrency - Supplier's price currency.

5. Rooms:

Room  [  ]

5.A. AdultsCount - Number of adults in the room.

5.B. Availability - Available / On Request. End of [ ].

5.C. Id - Unique ID stores Room details.

5.D. KidsAges [  ] - Notice top comments. End of [ ].

5.E. Price: (Room Price)

5.E.1. Currency - (As explained in 4.A.)

5.E.2. FinalPrice - (As explained in 4.B.)

5.E.3. FinalPriceInSupplierCurrency - (As explained in 4.C.)

5.E.4. OriginalPrice - (As explained in 4.D.)

5.E.5. OriginalPriceInSupplierCurrency - (As explained in 4.E.)

5.E.6. SupplierCurrency - (As explained in 4.F.)

5.F. RoomBasis - Rooms Values

5.G. RoomBasisOriginal - Supplier value

5.H. RoomClass - Rooms Values

5.I. RoomClassOriginal - Supplier value

5.J. RoomType - Rooms Values

5.K. RoomTypeOriginal - Supplier value

6. SimplePrice - Might be returned in some DetailLevel - similar to FinalPrice in its meaning.

7. Refundability - Indicates whether the rate is refundable or not. True = Refundable. False = Non-Refundable. This indication should not replace the call to get cancellation policy, since not all suppliers might return this indicator.
While using JSON, instead you'll receive either '1' or '2'.
1 - Refundable
2 - Nonrefundable
Sometimes, nothing will return, as the suppliers have not returned this information.

8. RefundableUntil - Date until the package is Refundable.

This indication should not replace the call to get cancellation policy.

9. Remarks (List<string>): Contains essential textual information that returned from the supplier, such as city taxes, check-in hours, etc.

10. SupplierId

11. SupplierName