List Pending Bookings - API

This method returns a list of bookings not marked as synced.

After the user calls this method and takes appropriate action then they must use the Sync Booking API method to mark each booking as synced.

The body of each booking can be retrieved using the Booking Retrieval API method.

The booking list is unique per Hotelier API Account. This means that each API account, even for the same property, have independent sync state.

URL Endpoint

/reservation/new

Booking PUSH / PING

WebHotelier supports real-time booking notifications.

If possible, use PING instead of calling this method on schedule or just use PUSH instead.

Warning

This method is only accessible using a Hotelier API account.

Warning

You MUST not call this method more often than every 5 minutes.

Warning

This method MUST not be called simultaneously by more than one thread or process for the same property, to avoid unexpected results. WebHotelier does not enforce this requirement.

Multiple threads reading the same list of pending bookings may result in duplicate bookings in your system.

Warning

WebHotelier confirmation numbers are globally unique.

Your system should never accept a "new" booking with a previously imported confirmation number (id).

Caution

Repeated failure of marking bookings as synced may result in a ban of your API account or your IP address.

JSON Response Schema

{
	"method": "https://rest.reserve-online.net/reservation/new"
	"http_method": "GET",
	"http_code": 200,
	"error_code": "OK",
	"error_msg": "",
	"data":{
		"records": INTEGER, // Count of records in the reservations array
		"reservations":[
			{
				"id":INTEGER, // Booking confirmation number
				"timestamp":ISO 8601, // When the booking was added to the sync-queue (ISO 8601 UTC format)
				"syncType":STRING // Why the booking was added to the sync-queue. Enumerated value: NEW, MOD, CL
			}
		]
	}
}