Real time availability request
Availability Request
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 | Content |
|---|---|---|
providerApartmentId | String | Apartment ID in your system |
arrival | LocalDate: YYYY-MM-DD | Date the customer wants to check-in |
departure | LocalDate: YYYY-MM-DD | Date the customer wants to check-out |
provider | String | An identifier in our system |
persons | Integer | Amount of persons |
You can provide any endpoint URL you like. The parameters will always be added in the following way.
Example:
In this example, https://your-endpoint-url.com/availability-request ← this will be the configurable part of the URL that you can provide us with.
The rest of the URL ?providerApartmentId=123abc&arrival=2020-12-23&departure=2020-12-30&persons=123&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 | Impact |
|---|---|---|
| 200 | OK, apartment available for those dates | The apartment is shown as available |
| 404 | Not found, the apartment requested does not exist or is deactivated | The property will be immediately deactivated on Holidu |
| 409 | Conflict, the apartment is not available | The apartment is shown as not available |
| 5xx | Server error | If this error happens often in a row, we will pause your connection until it is resolved |
Please make sure to use the right status codes
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.
Please make sure to keep the response time ideally under 2s in order to prevent timeouts.
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 4 months ago