WebHotelier supports automatic launching of availability search by passing GET or POST parameters as displayed below. We strongly recommend of using POST ( an HTML form ) whenever possible in order to avoid appending query keys to the booking engine URL.

Table of Contents
  1. Supported parameters
  2. Usage
  3. Examples of POST requests
  4. Examples of GET requests
  5. Download an HTML example

Supported parameters

NAME TYPE RANGE / SET REQUIRED DEFAULT EXAMPLE NOTES
checkin ISO 8601
( YYYY-MM-DD )
today+X
from today
to (today + 2 years)
YES &checkin=2017-07-28
&checkin=today+1
 
checkout ISO 8601
( YYYY-MM-DD )
today+X
from (checkin + 1)
to (checkin + 90)
NO checkin + 1 day &checkout=2017-08-04
&checkout=today+7
When used, number of nights is automatically calculated. Number of nights cannot exceed 90, but limitations apply ( see nights ).
DO NOT USE WITH NIGHTS PARAMETER
nights integer 1 – 90 NO 1 &nights=2 Maximum value can be limited by the hotelier ( default max = 20 ).
DO NOT USE WITH CHECKOUT PARAMETER
adults integer 1 – max capacity NO 2 &adults=3 The value is PER ROOM. Maximum value is automatically calculated based on the maximum possible capacity of hotel's rooms.
children integer 0 – (max capacity-1) NO 0 &children=2 The value is PER ROOM. Maximum value equals (maximum capacity - 1).
infants integer 0 – (max capacity-1) NO 0 &infants=1 The value is PER ROOM. Maximum value equals (maximum capacity - 1).
rooms integer 1 – 10 NO 1 &rooms=2 Maximum value can be limited by the hotelier ( default max = 5 ).
day string MON, TUE,
WED, THU,
FRI, SAT,
SUN
NO &day=TUE
&day=WED-FRI
&day=MON*WED*SUN
Defines a day or a set of acceptable check-in days. Uses checkin as a starting point and moves to the next acceptable day.
Use a dash for a range, e.g WED-FRI for Wednesday through Friday.
Use a * to delimit a custom set

Supported parameters ( Multi-Property Only )

NAME TYPE RANGE / SET REQUIRED DEFAULT EXAMPLE NOTES
property string PROPERTY CODE NO &property=HTLCODE Opens the engine directly to the specified property
properties string PROPERTY CODE LIST NO &properties=HTLCODEA,HTLCODEB Filters results only to specified properties code
location string VALID GEO NAME NO &location=Athens Filters only the properties that resolve to this location
DO NOT USE WITH THE GEO PARAM
geo string LAT,LON,DISTANCE
LAT1,LON1,LAT2,LON2
NO &geo=40.000,50.000,2
&geo=40.000,50.000,41.000,51.000
Filters only the properties that resolve to this coordinates. It has two modes:
DISTANCE MODE: Send latitude/longitude with a distance in Km from that point
BOUNDING BOX MODE: Send north-east & south-west coordinates

DO NOT USE WITH THE LOCATION PARAM
rating integer 1 – 5 NO &rating=1 Filters only the properties that have this rating ( e.g. stars )

Usage

The only required parameter is CHECKIN. Please, choose to use either CHECKOUT or NIGHTS, never both.

Combine paramaters

The above parameters can be combined with Voucher Code, Booking Code, and Language Selection method parameters.

It is recommended that Date form fields should use a date picker widget in order to provide a user-friendly experience. A free and open-source datepicker is included with JQuery UI and can be easily integrated. Numeric parameters should be select box fields. Note that not all fields are required ( e.g. rooms ) and can be safely omitted.

We suggest matching the design of the WebHotelier's availability form for a consistent client experience. Please, do not include the booking engine inside an IFRAME. A frame busting technique is used to prohibit this.

Example of POST request using a standard HTML form

<form action="https://example.reserve-online.net/" method="post">
	<input type="hidden" name="lang" value="en_GB">

	<label for="checkin">Check-in</label>
	<input id="checkin" name="checkin" size="12" maxlength="10" placeholder="dd/mm/yyyy" value="15/05/2008">

	<label for="nights">Staying for</label>
	<select id="nights" name="nights">
		<option value="1" selected="selected">1 night</option>
		<option value="2">2 nights</option>
		<option value="3">3 nights</option>
		<option value="4">4 nights</option>
		<option value="5">5 nights</option>
		<option value="6">6 nights</option>
		<option value="7">7 nights</option>
	</select>

	<label for="rooms">Rooms</label>
	<select id="rooms" name="rooms">
		<option value="1" selected="selected">1 room</option>
		<option value="2">2 rooms</option>
		<option value="3">3 rooms</option>
		<option value="4">4 rooms</option>
	</select>

	<label for="adults">Adults per room</label>
	<select id="adults" name="adults">
		<option value="1">1 adult</option>
		<option value="2" selected="selected">2 adults</option>
		<option value="3">3 adults</option>
		<option value="4">4 adults</option>
	</select>

	<label for="children">Children per room</label>
	<select id="children" name="children">
		<option value="0" selected="selected">no children</option>
		<option value="1">1 child</option>
		<option value="2">2 children</option>
		<option value="3">3 children</option>
	</select>

	<label for="infants">Infants per room</label>
	<select id="infants" name="infants">
		<option value="0" selected="selected">no infants</option>
		<option value="1">1 infant</option>
		<option value="2">2 infants</option>
	</select>

	<button type="submit" class="prime">Room Search</button>
</form>

Examples of GET requests

https://example.reserve-online.net/?checkin=2017-07-28&nights=7&adults=1&children=0&rooms=1
https://example.reserve-online.net/?checkin=2017-07-28&checkout=2017-08-04&adults=2

Download an HTML example

The following link contains a complete HTML example of the FORM request method. It also includes a date picker widget ( using JQuery UI ) that provides a friendly method for selecting dates. This, of course, can be replaced with any other similar widget or framework:

View Example