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 partnersupport@holidu.com

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&provider=XYZ

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&provider=XYZ 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