Skip to main content

Apartment

📄️Create or update an apartment

Creates the apartment on the first call for a `providerApartmentId` and updates it on later calls; call it first, because all other apartment endpoints need the apartment to exist. Updates are not partial: always send the complete apartment object, as most omitted fields are cleared (leaving out `providerApartmentGroupId` removes a unit from its multi-unit). New apartments are inactive until you call PUT /v2/apartment/activate; on creation `providerApartmentId` may only contain letters, digits and `._:-` (at most 120 characters).

📄️Get validation result of apartment

Returns Holidu's latest validation result for the apartment: `valid` and the problems in your data as `errorCode` and `message` (the codes are explained in the Validation guide); `valid` can be false with an empty list when Holidu-side checks fail or data is incomplete. Call it after pushing all data or when an active apartment is not bookable. It returns the stored result and runs a validation on the spot only if none exists yet, so data you have just pushed may not be reflected yet. `lastValidatedAt` is formatted `yyyy-MM-dd HH:mm:ss`.