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]


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:
true When the customer would check in
departure localDate:
true When the customer would check out


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.


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: