Availability endpoint

This endpoint needs to be implemented by partners connecting to Holidu’s API and willing to have their properties bookable on Holidu. Holidu will send a request asking for the availability status of a property for a specific stay. The partners need to answer whether the property is available or not. Please send the urls to these endpoints to [email protected]

AvailabilityRequest

This is a GET request that we will send to know whether the property is available or not. It contains the following parameters:

Field	Type	Required	Content
apartmentId	string	true	Apartment ID in your system
arrival	localDate: YYYY-MM-DD	true	When the customer would check in
departure	localDate: YYYY-MM-DD	true	When the customer would check out

Example
https://your-endpoint-url.com/availability-request?apartmentId=123abc&arrival=2020-12-23&departure=2020-12-30

In this example, https://your-endpoint-url.com/availability-request this will be the configurable part of the URL where you can provide us the URL of your availability endpoint. The rest of the URL ?apartmentId=123abc&arrival=2020-12-23&departure=2020-12-30 will always have this fixed format.

AvailabilityResponse

You should respond to the AvailabilityRequest with the following HTTP status codes:

HTTP Status Code	Meaning
200 OK	The property is available on those dates
409 Conflict	The property is not available on those dates

❗️
Please make sure to only respond with a status code of 200 if the apartment is available. Independent on any error message it will be shown as available.

👍
For security measures we recommend you to whitelist our IPs so that we can only do requests to you from the following IPs:

54.77.51.111

34.249.124.33

212.114.208.106

99.80.89.251

34.242.187.158

34.250.93.237