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 |
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
Updated about 2 months ago