# Holidu Developer Hub Documentation

> Our Holidu API allows you to connect with millions of travellers all over the world, simply by developing a few HAPI endpoints.

Every page below has a Markdown version at its URL plus `.md`; sending `Accept: text/markdown` to a page URL returns the same Markdown.

- Connectivity API (HAPI v2) OpenAPI spec: https://developer.holidu.com/openapi/connectivity-api.json
- Affiliate API OpenAPI spec: https://developer.holidu.com/openapi/affiliate-api.json
- All pages in one file: https://developer.holidu.com/llms-full.txt
- Agent skills (agentskills.io discovery index): https://developer.holidu.com/.well-known/agent-skills/index.json
- API catalog (RFC 9727): https://developer.holidu.com/.well-known/api-catalog
- MCP server (read-only; search and read these docs, look up operations, check sandbox validation): https://developer.holidu.com/mcp

## Guides
- [Requirements](https://developer.holidu.com/docs/certification.md)
- [Best practices](https://developer.holidu.com/docs/best-practices.md)
- [Generating API Client Code](https://developer.holidu.com/docs/generating-api-client-code.md)
- [Required Steps to implement Holidu Payment](https://developer.holidu.com/docs/required-steps-to-implement-holidu-payment.md)
- [HAPI version 1 to version 2 Migration Guide](https://developer.holidu.com/docs/hapi-version-1-to-version-2-migration-guide.md)
- [Request URLs](https://developer.holidu.com/docs/request-urls.md)
- [Listings](https://developer.holidu.com/docs/the-apartment-object.md)
- [Apartments](https://developer.holidu.com/docs/general-static-data.md)
- [Descriptions](https://developer.holidu.com/docs/localization.md)
- [Photos](https://developer.holidu.com/docs/photos.md)
- [Facilities](https://developer.holidu.com/docs/facilities.md)
- [Reviews](https://developer.holidu.com/docs/reviews-1.md)
- [Validation](https://developer.holidu.com/docs/validation.md)
- [A Multi-Unit Parent Listing](https://developer.holidu.com/docs/multi-unit-parent-listing.md)
- [A Multi-Unit Parent Listing Description](https://developer.holidu.com/docs/multi-unit-parent-listing-description.md)
- [A Multi-Unit Parent Listing Photos](https://developer.holidu.com/docs/multi-unit-parent-listing-photos.md)
- [A Multi-Unit Parent Listing Facilities](https://developer.holidu.com/docs/multi-unit-parent-listing-facilities.md)
- [Price and availability](https://developer.holidu.com/docs/price-and-availability.md)
- [Length of stay (LOS)](https://developer.holidu.com/docs/length-of-stay-los.md)
- [Availability and rates](https://developer.holidu.com/docs/availability-and-rates.md)
- [Extra costs](https://developer.holidu.com/docs/extra-costs-1.md)
- [Discounts](https://developer.holidu.com/docs/discounts-1.md)
- [Booking terms](https://developer.holidu.com/docs/apartment-configuration.md)
- [Payment configuration](https://developer.holidu.com/docs/payment-configuration.md)
- [Cancellation conditions](https://developer.holidu.com/docs/cancellation-conditions.md)
- [Terms and conditions](https://developer.holidu.com/docs/terms-and-conditions.md)
- [Apartment activation & deactivation](https://developer.holidu.com/docs/apartment-activation.md)
- [Booking object](https://developer.holidu.com/docs/booking-object.md)
- [Update bookings](https://developer.holidu.com/docs/update-bookings.md)
- [Cancel bookings](https://developer.holidu.com/docs/cancel-bookings.md)
- [Get booking details](https://developer.holidu.com/docs/get-bookings.md)
- [Endpoints on your side](https://developer.holidu.com/docs/what-is-onsite-booking.md)
- [Real time availability request](https://developer.holidu.com/docs/real-time-availability-request.md)
- [Real time booking request](https://developer.holidu.com/docs/booking-notification-body.md)
- [Receiving a booking](https://developer.holidu.com/docs/booking-notification.md)
- [Credit Card Payment Through PCI](https://developer.holidu.com/docs/credit-card-payment-through-pci.md)
- [Real time booking cancellation notification](https://developer.holidu.com/docs/real-time-booking-cancellation-notification.md)
- [Real-time booking modification notification](https://developer.holidu.com/docs/real-time-booking-modification-notification.md)
- [Build with AI](https://developer.holidu.com/docs/build-with-ai.md): Point an AI coding assistant (Claude Code, Cursor, Codex, Copilot) at the Holidu developer hub: Markdown pages, llms.txt, the OpenAPI spec and an integration skill.
- [Frequently asked questions](https://developer.holidu.com/docs/faq.md)
- [Booking Cancellation Notification](https://developer.holidu.com/docs/modification-cancellation-notification.md)

## API Reference
- [Connectivity API](https://developer.holidu.com/reference/connectivity-api.md): Introduction: base URLs and authentication.
- [Apartment](https://developer.holidu.com/reference/apartment.md): 6 operation(s)
- [Availability](https://developer.holidu.com/reference/availability.md): 2 operation(s)
- [Booking Terms](https://developer.holidu.com/reference/booking-terms.md): 10 operation(s)
- [Bookings](https://developer.holidu.com/reference/bookings.md): 3 operation(s)
- [Descriptions](https://developer.holidu.com/reference/descriptions.md): 2 operation(s)
- [Discounts](https://developer.holidu.com/reference/discounts.md): 3 operation(s)
- [Extra Costs](https://developer.holidu.com/reference/extra-costs.md): 2 operation(s)
- [Facilities](https://developer.holidu.com/reference/facilities.md): 4 operation(s)
- [LOS](https://developer.holidu.com/reference/los.md): 4 operation(s)
- [MultiUnit Facility](https://developer.holidu.com/reference/multi-unit-facility.md): 2 operation(s)
- [MultiUnit Localization](https://developer.holidu.com/reference/multi-unit-localization.md): 2 operation(s)
- [MultiUnit Photo](https://developer.holidu.com/reference/multi-unit-photo.md): 2 operation(s)
- [MultiUnit](https://developer.holidu.com/reference/multi-unit.md): 2 operation(s)
- [Photos](https://developer.holidu.com/reference/photos.md): 2 operation(s)
- [Rates](https://developer.holidu.com/reference/rates.md): 2 operation(s)
- [Reviews](https://developer.holidu.com/reference/reviews.md): 2 operation(s)
- [Deactivate apartment for provider](https://developer.holidu.com/reference/deactivateapartment.md)
- [Activate apartment for provider](https://developer.holidu.com/reference/activateapartment.md)
- [Get an apartment](https://developer.holidu.com/reference/getapartment.md)
- [Create or update an apartment](https://developer.holidu.com/reference/upsertapartment.md)
- [Get basic information about all apartments](https://developer.holidu.com/reference/getallapartmentinformation.md)
- [Get validation result of apartment](https://developer.holidu.com/reference/getapartmentvalidation.md)
- [Get descriptions for an apartment](https://developer.holidu.com/reference/getapartmentdescriptions.md)
- [Create or update descriptions for an apartment](https://developer.holidu.com/reference/upsertapartmentdescriptions.md)
- [Get facilities for apartment](https://developer.holidu.com/reference/getfacilities.md)
- [Update facilities for an apartment](https://developer.holidu.com/reference/updatefacilities.md)
- [Get facility types](https://developer.holidu.com/reference/getfacilitytypes.md)
- [Get facility locations](https://developer.holidu.com/reference/getfacilitylocations.md)
- [Get photos for an apartment](https://developer.holidu.com/reference/getphotos.md)
- [Update photos for an apartment](https://developer.holidu.com/reference/updatephotos.md)
- [Get customer reviews for apartment](https://developer.holidu.com/reference/getcustomerreviews.md)
- [Post the customer reviews of an apartment](https://developer.holidu.com/reference/updatecustomerreviews.md)
- [Get LOS for an apartment](https://developer.holidu.com/reference/getlos.md)
- [Create or update LOS for an apartment](https://developer.holidu.com/reference/upsertlos.md)
- [Delete LOS for an apartment](https://developer.holidu.com/reference/deletelos.md)
- [Get LOS rate Ids for an apartment](https://developer.holidu.com/reference/getlosrateids.md)
- [Get apartment availability](https://developer.holidu.com/reference/getavailability.md)
- [Update apartment availability](https://developer.holidu.com/reference/updateavailability.md)
- [Get apartment rate plans](https://developer.holidu.com/reference/getrates.md)
- [Update apartment rate plans](https://developer.holidu.com/reference/setrates.md)
- [Get the extra costs of an apartment](https://developer.holidu.com/reference/getextracosts.md)
- [Update the extra costs of an apartment](https://developer.holidu.com/reference/updateextracosts.md)
- [Get a single discount for an apartment by discount id](https://developer.holidu.com/reference/getdiscountbyid.md)
- [Create or update a single discount for an apartment](https://developer.holidu.com/reference/upsertdiscount.md)
- [Get discounts for an apartment](https://developer.holidu.com/reference/getdiscounts.md)
- [Get terms and conditions for apartment](https://developer.holidu.com/reference/gettermsandconditions.md)
- [Update terms and conditions for apartment](https://developer.holidu.com/reference/updatetermsandconditions.md)
- [Get payment configuration for apartment](https://developer.holidu.com/reference/getpaymentconfiguration.md)
- [Update payment configuration for apartment](https://developer.holidu.com/reference/updatepaymentconfiguration.md): Replaces existing payment configurations with new ones for apartment
- [Delete payment configuration for apartment](https://developer.holidu.com/reference/deletepaymentconfiguration.md): Deletes existing payment configuration for apartment
- [Get cancellation conditions for apartment](https://developer.holidu.com/reference/getcancellationpolicy.md)
- [Update cancellation conditions for apartment](https://developer.holidu.com/reference/updatecancellationconditions.md): Replaces any pre-configured cancellation policies with new ones for Apartment
- [Delete cancellation policy for apartment](https://developer.holidu.com/reference/deletecancellationpolicy.md): Deletes existing cancellation policy for apartment
- [Get payment configuration rateIds for apartment](https://developer.holidu.com/reference/getpaymentconfigurationrateids.md)
- [Get cancellation policy rate Ids for apartment](https://developer.holidu.com/reference/getcancellationpolicyrateids.md)
- [Update booking details](https://developer.holidu.com/reference/updatebooking.md)
- [Cancel a booking](https://developer.holidu.com/reference/cancelbooking.md)
- [Get booking details](https://developer.holidu.com/reference/getbookingdetails.md)
- [Get parent apartment in multi-unit structure](https://developer.holidu.com/reference/getmultiunit.md)
- [Create or update parent apartment in multi-unit structure](https://developer.holidu.com/reference/upsertmultiunit.md)
- [Get descriptions for a multi-unit](https://developer.holidu.com/reference/getmultiunitdescriptions.md)
- [Update descriptions for a multi-unit](https://developer.holidu.com/reference/updatemultiunitdescriptions.md)
- [Get photos for a multi-unit](https://developer.holidu.com/reference/getmultiunitphotos.md)
- [Update photos for a multi-unit](https://developer.holidu.com/reference/updatemultiunitphotos.md)
- [Get facilities for a multi-unit](https://developer.holidu.com/reference/getmultiunitfacilities.md)
- [Update facilities for a multi-unit](https://developer.holidu.com/reference/updatemultiunitfacilities.md)
- [API response codes](https://developer.holidu.com/reference/api-response-codes.md)
- [How to Integrate with Holidu: Capabilities & Use Cases](https://developer.holidu.com/reference/how-to-integrate-with-holidu-capabilities-use-cases.md)
- [Introduction](https://developer.holidu.com/reference/intro-1.md)
- [Intro](https://developer.holidu.com/reference/intro.md)
- [Property Types](https://developer.holidu.com/reference/property-types.md)
- [/search](https://developer.holidu.com/reference/search.md)
- [Languages & Currencies](https://developer.holidu.com/reference/supported-languages-currencies.md)
- [Versioning](https://developer.holidu.com/reference/versioning.md)
- [Search for offers based on the provided criteria](https://developer.holidu.com/reference/search-1.md): Retrieve a paginated list of offers matching specified filtering criteria, ranked by relevance. If dates are provided, only available offers for those dates are returned with exact pricing. Each offer includes basic property information.
- [Get detailed information about the provided offers](https://developer.holidu.com/reference/details-1.md): Retrieve detailed static information for specified offers. The "extras" parameter allows for the inclusion of additional data points to the response. The response includes an RFC 6570-compatible "urlTemplate" for generating checkout page links with check-in and check-out dates. If some requested offers cannot be retrieved, these will be reported in the "errors" array, with the corresponding property identifier, error code, and descriptive message.
- [Get information about the availability of given offers](https://developer.holidu.com/reference/availabilities-1.md): Retrieve real-time prices and availability for specified properties on given dates.
- [Get a list of property IDs that have changed within the specified time window.](https://developer.holidu.com/reference/changed-1.md): Returns property IDs with data potentially updated within the specified time range. The inventory is continuously refreshed, with more frequent updates for recent days.
- [Create or replace LOS data for an apartment](https://developer.holidu.com/reference/upsertlos-1.md): Holidu calls this endpoint to push the complete LOS data for an apartment to the affiliate.

## API Schemas
- [Apartment Rates (schema)](https://developer.holidu.com/reference/schemas/apartment-rates.md)
- [ApartmentAddress (schema)](https://developer.holidu.com/reference/schemas/apartmentaddress.md): Address of the rental property
- [ApartmentAvailability (schema)](https://developer.holidu.com/reference/schemas/apartmentavailability.md)
- [ApartmentCancellationPolicy (schema)](https://developer.holidu.com/reference/schemas/apartmentcancellationpolicy.md)
- [ApartmentDescription (schema)](https://developer.holidu.com/reference/schemas/apartmentdescription.md)
- [ApartmentExtraCost (schema)](https://developer.holidu.com/reference/schemas/apartmentextracost.md)
- [ApartmentFacility (schema)](https://developer.holidu.com/reference/schemas/apartmentfacility.md)
- [ApartmentInformation (schema)](https://developer.holidu.com/reference/schemas/apartmentinformation.md)
- [ApartmentInformationPage (schema)](https://developer.holidu.com/reference/schemas/apartmentinformationpage.md)
- [ApartmentPaymentConfiguration (schema)](https://developer.holidu.com/reference/schemas/apartmentpaymentconfiguration.md): Payment configuration (payment methods and rates) applicable on booking
- [ApartmentTermsAndConditions (schema)](https://developer.holidu.com/reference/schemas/apartmenttermsandconditions.md): Terms and conditions which apply on booking for the given countries
- [ApartmentValidation (schema)](https://developer.holidu.com/reference/schemas/apartmentvalidation.md)
- [AvailableTime (schema)](https://developer.holidu.com/reference/schemas/availabletime.md): Time until facility would be available
- [BasicApartmentDto (schema)](https://developer.holidu.com/reference/schemas/basicapartmentdto.md)
- [BookingCancellationResponse (schema)](https://developer.holidu.com/reference/schemas/bookingcancellationresponse.md)
- [BookingDetails (schema)](https://developer.holidu.com/reference/schemas/bookingdetails.md)
- [BookingDiscount (schema)](https://developer.holidu.com/reference/schemas/bookingdiscount.md)
- [BookingExtraCost (schema)](https://developer.holidu.com/reference/schemas/bookingextracost.md)
- [BookingUpsert (schema)](https://developer.holidu.com/reference/schemas/bookingupsert.md)
- [BookingUpsertExtraCost (schema)](https://developer.holidu.com/reference/schemas/bookingupsertextracost.md): Breakdown of extra costs for the booking.
- [CancellationFee (schema)](https://developer.holidu.com/reference/schemas/cancellationfee.md)
- [CheckInCheckOutTimes (schema)](https://developer.holidu.com/reference/schemas/checkincheckouttimes.md): Check-ins and check-outs details
- [CheckInDuration (schema)](https://developer.holidu.com/reference/schemas/checkinduration.md): List of possible check in times
- [Commission (schema)](https://developer.holidu.com/reference/schemas/commission.md)
- [CompleteApartmentDto (schema)](https://developer.holidu.com/reference/schemas/completeapartmentdto.md)
- [ContactDetails (schema)](https://developer.holidu.com/reference/schemas/contactdetails.md): Contact details
- [CustomerDetails (schema)](https://developer.holidu.com/reference/schemas/customerdetails.md): Model of the Customer.
- [CustomerReviewDto (schema)](https://developer.holidu.com/reference/schemas/customerreviewdto.md)
- [Daily Rate (schema)](https://developer.holidu.com/reference/schemas/daily-rate.md): List of daily rates
- [DiscountConditions (schema)](https://developer.holidu.com/reference/schemas/discountconditions.md)
- [DiscountDto (schema)](https://developer.holidu.com/reference/schemas/discountdto.md)
- [DuplicateFrom (schema)](https://developer.holidu.com/reference/schemas/duplicatefrom.md): Use this object if other Holidu partners also have this property in their system. Please contact us before using this.
- [ExtraCostCondition (schema)](https://developer.holidu.com/reference/schemas/extracostcondition.md): Conditions applicable for extra cost
- [ExtraCostPrice (schema)](https://developer.holidu.com/reference/schemas/extracostprice.md): Price configuration for extra cost
- [FacilityAvailabilityData (schema)](https://developer.holidu.com/reference/schemas/facilityavailabilitydata.md)
- [Guest (schema)](https://developer.holidu.com/reference/schemas/guest.md)
- [GuestCapacityRules (schema)](https://developer.holidu.com/reference/schemas/guestcapacityrules.md): Guest capacity rules applicable to apartment
- [HoliduErrorResponse (schema)](https://developer.holidu.com/reference/schemas/holiduerrorresponse.md)
- [HostResponseDto (schema)](https://developer.holidu.com/reference/schemas/hostresponsedto.md): Host's response to this review (text, language, timestamp). Optional. Only set when the host has replied to the guest review.
- [LengthOfStay (schema)](https://developer.holidu.com/reference/schemas/lengthofstay.md): Extra cost only applicable if lengthOfStay shorter than
- [LOS (schema)](https://developer.holidu.com/reference/schemas/los.md)
- [LOS Item (schema)](https://developer.holidu.com/reference/schemas/los-item.md): Length of Stay. Keyed by check-in date (YYYY-MM-DD). Each value lists the price tiers available for that date, one entry per guest count.
- [MetaData (schema)](https://developer.holidu.com/reference/schemas/metadata.md)
- [MultiUnitDescriptionDto (schema)](https://developer.holidu.com/reference/schemas/multiunitdescriptiondto.md): Localization data for a multi-unit
- [MultiUnitDto (schema)](https://developer.holidu.com/reference/schemas/multiunitdto.md)
- [MultiUnitFacility (schema)](https://developer.holidu.com/reference/schemas/multiunitfacility.md)
- [OnRequestDetails (schema)](https://developer.holidu.com/reference/schemas/onrequestdetails.md): Used only for on request apartments
- [Payment (schema)](https://developer.holidu.com/reference/schemas/payment.md)
- [PaymentRate (schema)](https://developer.holidu.com/reference/schemas/paymentrate.md)
- [PaymentRatePerDate (schema)](https://developer.holidu.com/reference/schemas/paymentrateperdate.md)
- [PaymentRates (schema)](https://developer.holidu.com/reference/schemas/paymentrates.md): Payment schedule for the booking
- [PaymentWithBooking (schema)](https://developer.holidu.com/reference/schemas/paymentwithbooking.md)
- [PhotoDto (schema)](https://developer.holidu.com/reference/schemas/photodto.md)
- [PhotoLocalizationDto (schema)](https://developer.holidu.com/reference/schemas/photolocalizationdto.md): Photo titles in different languages
- [Price (schema)](https://developer.holidu.com/reference/schemas/price.md): Price with amount and currency
- [PriceDto (schema)](https://developer.holidu.com/reference/schemas/pricedto.md)
- [Rate Plan (schema)](https://developer.holidu.com/reference/schemas/rate-plan.md)
- [Receipt (schema)](https://developer.holidu.com/reference/schemas/receipt.md)
- [Room (schema)](https://developer.holidu.com/reference/schemas/room.md): Room
- [SeasonApplicable (schema)](https://developer.holidu.com/reference/schemas/seasonapplicable.md): Season for which extra cost is applicable
- [ValidationErrorMessage (schema)](https://developer.holidu.com/reference/schemas/validationerrormessage.md): Validation Error Messages
- [LosDto (schema)](https://developer.holidu.com/reference/affiliate/schemas/losdto.md): The Length of Stay (LOS) represents accumulated prices per check-in date and length of stay. If the map is empty, no pricing is available for the apartment.
- [LosItemDto (schema)](https://developer.holidu.com/reference/affiliate/schemas/lositemdto.md): A price configuration for a specific check-in date, guest count, and currency.
- [ProblemDetail (schema)](https://developer.holidu.com/reference/affiliate/schemas/problemdetail.md): Error response following [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) Problem Details for HTTP APIs. Affiliates are encouraged to use this format for error responses to aid Holidu in debugging push failures.

## Recipes
- [Basic LOS](https://developer.holidu.com/recipes/basic-los.md)
- [Recipe Title](https://developer.holidu.com/recipes/recipe-title.md)

## Pages
- [Holidu Whitelabels](https://developer.holidu.com/page/holidu-whitelabels.md): Holidu Whitelabels

## Changelog
- [📈 Digest into multi-rates in Holidu API!](https://developer.holidu.com/changelog/digest-into-multi-rates-in-holidu-api.md)
- [Check out our newly added feature - Booking lead time](https://developer.holidu.com/changelog/draft-check-out-our-newly-added-feature-booking-lead-time.md)
- [Meet our enhanced Discount Endpoint!](https://developer.holidu.com/changelog/our-new-discount-endpoint.md)
- [Let's enhance facilities!](https://developer.holidu.com/changelog/lets-enhance-facilities.md)
- [Holidu API V2 is Officially Released!](https://developer.holidu.com/changelog/hapi-version-2-is-officially-released.md)
- [Get ready to migrate to Holidu API V2!](https://developer.holidu.com/changelog/hapi-version-1-is-deprecated.md)
- [Keep Your Apartment Information Accurate and Up-to-Date with Our New /validation Endpoint](https://developer.holidu.com/changelog/keep-your-apartment-information-accurate-and-up-to-date-with-our-new-validation-endpoint.md)
- [Holidu is in preparation for version 2 of the API.](https://developer.holidu.com/changelog/announcing-preparation-for-version-2.md)
- [Welcome to the brand new developer hub](https://developer.holidu.com/changelog/welcome-to-the-brand-new-developer-hub.md)