Method to externally manage room availability
/manage/availability
This method is only accessible using a Hotelier API account.
This method is only accessible using a POST request.
To get a response in JSON make sure you are also sending the Accept: application/json header.
Post a JSON document with the following structure:
{ "ROOMCODE": [ { "from":ISO 8601, // Starting date for period updates, mutually exclusive with "date" "to":ISO 8601, // Ending date for period update, mutually exclusive with "date" "date":ISO 8601, // Single-date update, mutually exclusive with "from" and "to" "weekdays":STRING[], // Specific days of week to apply the update (Sun, Mon, Tue, Wed, Thu, Fri, Sat) "allot":INTEGER, // Allotment for date or date-period (optional, negative values are not allowed) "stopsell":BOOLEAN, // 1=Stop Sell Restriction, 0=No restriction (optional) "minstay":INTEGER, // Minimum stay in days (optional, zero value is not allowed) "maxstay":INTEGER, // Maximum stay in days (optional, to remove restriction send 0) "checkin":BOOLEAN // 1=Check-in is allowed, 0=Check-in not allowed (optional) "checkout":BOOLEAN // 1=Check-out is allowed, 0=Check-out not allowed (optional) } ] }
Request body must be in valid JSON format.
Updates are made only if the entire request body is successfully parsed and validated.
Updates are transactional, that means that the entire batch of updates included in the request will either succeed or fail in its entirety. We guarantee that no request can partial mutate WebHotelier state.
You can use the Availability Feed method to validate WebHotelier state against your data.
We closely monitor all updates going in WebHotelier.
If best practices are not followed it may result in the banning of your API account or your IP address.
The following examples illustrate common use cases and possible combinations:
{ "DBL": [{"date":"2024-09-27","allot":5}] }
{ "DBL": [{"from":"2024-10-04","to":"2024-10-11","allot":7}] }
{ "DBL": [ {"date":"2024-09-27,"allot":5}, {"from":"2024-10-04","to":"2024-10-11","allot":7} ] }
{ "SGL": [ {"date":"2024-09-27,"allot":8}, {"from":"2024-10-04","to":"2024-10-11","allot":9} ], "DBL": [ {"date":"2024-09-27,"allot":15}, {"from":"2024-10-04","to":"2024-10-11","allot":20} ], "TRP": [ {"date":"2024-09-27,"allot":5}, {"from":"2024-10-04","to":"2024-10-11","allot":7} ] }
{ "DBL": [{"from":"2024-10-04","to":"2024-10-11","stopsell":1}] }
{ "DBL": [{"from":"2024-10-04","to":"2024-10-11","stopsell":0,"checkin":0,"minstay":7}] }
{ "SGL": [ {"from":"2024-10-04","to":"2024-10-11","stopsell":0,"checkin":0,"minstay":7}, {"date":"2024-09-27","stopsell":1,"allot":0} ], "DBL": [ {"from":"2024-10-04","to":"2024-10-11","stopsell":0,"checkin":1,"minstay":1}, {"date":"2024-09-27","stopsell":0,"allot":6} ] }
{ "DBL": [{"from":"2024-10-04","to":"2024-10-11","allot":7,"weekdays":["Sat", "Sun"]}] }