API documentation - Minimum requirements for going live

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 HERE!

What are the differences between Path 1 and Path 2? ⬅️

Path 1:

Endpoints

Content

Frequency

Details

Endpoints

Content

Frequency

Details

Apartment

  • GET → /rest/public/integration/apartment

  • DELETE → /rest/public/integration/apartment

  • POST → /rest/public/integration/apartments

Listings: including photos, facilities, location, etc

As soon as there is an update

Apartment information

LOS

  • GET → /rest/public/integration/los

  • POST → /rest/public/integration/los

Availabilities and prices via LOS - lenght 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 synchronisation

As soon as there is an update

Bookings 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 price

We will query it live (you will provide us an endpoint)

Availability Endpoint

Booking endpoint

You should create this endpoint so we can make live calls to confirm bookings

We will query it live (you will provide us an endpoint)

Booking notification

Path 2:

Endpoints

Content

Frequency

Details

Endpoints

Content

Frequency

Details

Apartment

  • GET → /rest/public/integration/apartment

  • DELETE → /rest/public/integration/apartment

  • POST → /rest/public/integration/apartments

Listings: including photos, facilities, location, etc

As soon as there is an update

Apartment information

Availability

  • GET → /rest/public/integration/apartments/availability

  • POST → /rest/public/integration/apartments/availability

Availabilities and blocked days

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.

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 days

Price - 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 synchronisation

As soon as there is an update

Bookings 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 price

We will query it live (you will provide us an endpoint)

Availability Endpoint

Booking endpoint

You should create this endpoint so we can make live calls to confirm bookings

We will query it live (you will provide us an endpoint)

Booking notification

Graph of minimum requirements:

  • There are other endpoints that you can develop but the ones above are the MINIMUM requirements to integrate with the Holidu API (HAPI)

  • Once the integration is working, if we do not receive data for 14 days in a row the information that hasn’t been updated will be deleted, thus it will no longer be available at Holidu