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 + 3 years)	YES	–	&checkin=2024-11-05 &checkin=today+1
checkout	ISO 8601 (YYYY-MM-DD) today+X	from (checkin + 1) to (checkin + 90)	NO	checkin + 1 day	&checkout=2024-11-12 &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
unit	string	apartment, bed, bungalow, chalet, cottage, dorm, house, lodge, maisonette, residence, room, studio, suite, villa	NO	–	&unit=bed	Filters availability results to specific unit type. Occupancy ranges are adjusted automatically.

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.

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=2024-11-05&nights=7&adults=1&children=0&rooms=1
https://example.reserve-online.net/?checkin=2024-11-05&checkout=2024-11-12&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