Hotel
The AvailabilitySearch is used to retrieve the available room options for a given combination of date, duration, occupancy & passenger nationality. It is possible to identify a region, individual hotel or list of hotels for your query. A small number of filters are also available to return only room options that match the criteria specified.
In response you will receive a list of rooms and meal types that are available across the hotels in our inventory that match your requirements and their Result id, with the total price that is inclusive of any discounts. The Result id for each option will subsequently be used as Quote id in BookingCreate stage of the booking flow.
Availability response times can vary between 3 – 20 seconds depending on the search criteria you have selected. Please discuss with our integrations team if you have any specific requirements for availability response time that are not being met.
Specifying search Target
You can target your search at either:
- One Region Id
- One Hotel Id
- Multiple Hotel Ids
The following rules apply when specifying the search target:
- If you wish to specify a single Hotel, then you must include the HotelId tag and you must omit the RegionId tag and the Hotels Tag.
- If you wish to specify a single Region, then you must include the RegionId tag and you must omit the HotelId tag and the Hotels Tag.
- If you wish to specify multiple Hotels, then you must include Hotels tag which will include the list of Hotel Ids, and omit the singular HotelId tag.
Availability Request Syntax
Request Header
Content-Type: “text/xml; charset=utf-8”
Content-Length: [Length of the content]
Host: [Web service hostname]
Accept-Encoding “gzip”
| Name | Type | Description |
|---|---|---|
|
<Authority> |
Complex |
Authentication information, as |
|
<Org> |
String |
The organisation short code identifying the agent responsible for the request (Agency ID) |
|
<User> |
String |
The user’s logon, unique within the given organisation (User Name) |
|
<Password> |
String |
The given user’s password |
|
<Currency> |
String |
Choose the currency used to return selling prices; accepts an ISO-4217 / SWIFT three character currency code (e.g. USD, GBP, EUR). Your account has a configured billing currency. Only the configured currency can be specified here. |
|
<Version> |
String |
The current interface version is 1.28 |
|
<HotelId> |
Integer |
The Id of an individual hotel to search for availability. This should not be used with a <RegionId> element |
|
<HotelStayDetails> |
Complex |
Structured information the rooms, passengers, dates, duration & passenger nationality to request availability |
|
<ArrivalDate> |
Date |
The date of the first night of the stay |
|
<Nights> |
Integer |
The duration of the stay as a number of nights |
|
<Nationality> |
String |
The country code of the guests’ nationality. This is required to ensure that the prices and availability returned are valid for the guests who are travelling. A list of Nationality codes can be obtained from the static data downloads on the Stuba Integration Portal. |
|
<Room> (1 or More) |
Complex |
Structure containing room requirement and occupant details |
|
<Guests> |
Array |
An array of either <Adult> or <Child> elements representing the guests who will stay in this room. |
|
<HotelSearchCriteria> (optional) |
Complex |
Structured extra requirements to filter the list of hotels returned You cannot use HotelSearchCriteria filter when also specifying a HotelId. |
|
<HotelName> (optional) |
String |
Match a text fragment within the hotel name |
|
<MinStars> (optional) |
Integer |
Return only hotels with at least this star rating |
|
<MinPrice> (optional) |
Decimal |
Return only hotels whose total cost (I.e. cost for the whole stay, not cost per night) is at least this value. |
|
<MaxPrice> (optional) |
Decimal |
Return only hotels whose total cost (I.e. cost for the whole stay, not cost per night) is at most this value. |
|
<CanxFees> (optional) |
Boolean |
When passed as true, availability response will contain additional cancellation policy information (if available) If false (or not included) default level of cancellation policy information is returned |
Response Body Schema
| Name | Type | Description |
|---|---|---|
|
<Currency> |
String |
The currency of all prices included in the response. |
|
<Warning> |
String |
Details of any non-fatal issues with the request, including any Hotel Id’s rejected. |
|
<TestMode> |
Boolean |
If ‘true’ the response is not from live environment. If ‘false’ the response is from live environment |
|
<HotelAvailability> (zero or more) |
Complex | |
|
<Hotel> |
Complex |
Contains hotel details |
|
<Result> (1 or more) |
Complex |
Contains details of a single search result matching the given search criteria |
|
Id (Attribute) |
String |
QuoteId for this search result to be passed in a booking create operation. |
|
<Room> (one or more) |
Complex |
Contains details of an individual room type included in this search result. A single result may contain multiple rooms if the search merits it. |
|
<RoomType> |
Complex |
A text enumeration (as a <code>, <text> pair) identifying a specific room type. These codes are obtained dynamically from the hotel and are obtained individually per hotel. |
|
<MealType> |
Complex |
A text enumeration (as a <code>, <text> pair) identifying a specific meal type. These codes are obtained dynamically from the hotel. If not returned the MealType is ‘room only’. |
|
<Price> |
Complex |
The total selling price for this search result, including any discounts and commission. |
|
<Messages> |
Complex |
Special notes provided by the hotel are provided here. These must be displayed to the guests. Not all messages are available at this stage in the booking process. |
|
<CancellationPolicyStatus> |
Enum |
A three-value text enumeration for the indicative cancellation policy status of the room. |
|
<CancelPolicy> (only present if CanxFees is true in request) |
Complex |
Contains additional cancellation policy details |
|
<From> (attribute) |
Date |
An indication of the first date cancellation charges apply |
XML Response Samples
Samples
