Booking Terms

📄️Get terms and conditions for apartment

Returns the terms-and-conditions URLs stored for the apartment, each with the countries it applies to.

📄️Update terms and conditions for apartment

Sets the URLs of your terms and conditions per country (ISO 3166-1 alpha-2) for the apartment. The list replaces all stored entries; an entry without countries is the fallback for every country that has no entry of its own. Holidu uses these apartment terms only if your account is set to per-apartment terms; otherwise your account's terms (or Holidu's) apply.

📄️Get payment configuration for apartment

Returns the payment methods and payment schedule of the apartment for one rate; without `rateId` the default rate. Answers 404 if none is stored.

📄️Update payment configuration for apartment

Sets the payment methods and payment schedule for one rate of the apartment (`rateId`, the default rate if omitted); configurations of other rates are kept, but pushing `REFUNDABLE` or `NON_REFUNDABLE` removes the default one. While a `REFUNDABLE` or `NON_REFUNDABLE` configuration is stored, one sent for the default rate is discarded, although the call answers 200 and echoes it. `ratePaidOnBookingInPercentage` plus all `ratesPerDate[].rateAmountInPercentage` must add up to exactly 100. Only needed if you collect payments yourself and the configuration differs from the one set for your account.

📄️Delete payment configuration for apartment

Deletes the payment configuration of one rate of the apartment; without `rateId` only the default configuration is deleted.

📄️Get cancellation conditions for apartment

Returns the cancellation fee tiers of the apartment for one rate; without `rateId` the default rate. Answers 404 if none are stored.

📄️Update cancellation conditions for apartment

Sets the cancellation fee tiers of the apartment: each tier charges `cancellationFeeInPercent` of the booking amount for cancellations up to and including the day `daysBeforeArrival` days before arrival, once the previous (longer) tier has ended. Include a tier with `daysBeforeArrival` 0, the fee for late cancellations and no-shows; the API does not reject a list without one. Tiers are grouped by `rateId` (the default rate if omitted): the tiers of each rate in the request replace the stored ones, other rates are kept and an empty list changes nothing. Pushing `REFUNDABLE` or `NON_REFUNDABLE` tiers removes the default ones, and while they are stored, tiers sent for the default rate are discarded although the call answers 200 with them.