These docs are for v1.0. Click to read the latest docs for v2.0.

Quick start guide

📘

Congratulations,

You are just a few steps away to start the integration to our Holidu API! Please choose ONE of the two paths to integrate with us. More info

1418

Path 1 - Using LOS (Recommended)

EndpointContentFrequencyDetails
Apartment
GET → /rest/public/integration/apartment
DELETE → /rest/public/integration/apartment
POST → /rest/public/integration/apartments
Listings: including photos, facilities, location, etcAs soon as there is an updateApartment information
LOS
GET → /rest/public/integration/los
POST → /rest/public/integration/los
Availabilities and prices via LOS - length of stay

This option is useful when your system allows to have different prices according to the length of stay
As soon as there is an update - at least once every 14 days

In order to keep a property live in our system, we must get updates. If we don’t get any data for a property, for more than 14 days we will delete it. E.g. you can send us updates once a week, apart from the data you send to us as soon as there is an update.
Price - LOS
Bookings data
POST (create or update a booking)→ /rest/public/integration/bookings
POST (cancel a booking)→ /rest/public/integration/bookings/cancel
GET → /rest/public/integration/bookings/details
Cancellation and modification synchronisationAs soon as there is an updateBookings data (cancellation and modification synchronisation)
Availability endpoint You should create this endpoint so we can make live calls to request availability when a user selects specific dates to get the priceWe will query it live (you will provide us an endpoint)Availability Endpoint
Booking endpointYou should create this endpoint so we can make live calls to confirm bookingsWe will query it live (you will provide us an endpoint)Booking notification

Path 2 - Using Rateplans

EndpointContentFrequencyDetails
Apartment
GET → /rest/public/integration/apartment
DELETE → /rest/public/integration/apartment
POST → /rest/public/integration/apartments
Listings: including photos, facilities, location, etcAs soon as there is an updateApartment information
Availability
GET → /rest/public/integration/apartments/availability
POST → /rest/public/integration/apartments/availability
Availabilities and blocked daysAs soon as there is an update - at least once every 14 days

In order to keep a property live in our system, we must get updates. If we don’t get any data for a property, for more than 14 days we will delete it. E.g. you can send us updates once a week, apart from the data you send to us as soon as there is an update.
Availability
RATES
GET → /rest/public/integration/apartments/rates
POST → /rest/public/integration/apartments/rates
Prices via Rates As soon as there is an update - at least once every 14 daysPrice - Rates
Bookings data
POST (create or update a booking)→ /rest/public/integration/bookings
POST (cancel a booking)→ /rest/public/integration/bookings/cancel
GET → /rest/public/integration/bookings/details
Cancellation and modification synchronisationAs soon as there is an updateBookings data (cancellation and modification synchronisation)
Availability endpointYou should create this endpoint so we can make live calls to request availability when a user selects specific dates to get the priceWe will query it live (you will provide us an endpoint)Availability Endpoint
Booking endpointYou should create this endpoint so we can make live calls to confirm bookingsWe will query it live (you will provide us an endpoint)Booking notification