Region
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 Region, then you must include the RegionId tag and you must omit the HotelId tag and the Hotels Tag.
- 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 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”
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. |
|
<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
