<?xml version="1.0" encoding="utf-8"?><?xml-stylesheet type="text/xsl" href="atom.xsl"?>
<feed xmlns="http://www.w3.org/2005/Atom">
    <id>https://developer.holidu.com/changelog</id>
    <title>Holidu developer hub Blog</title>
    <updated>2025-04-07T00:00:00.000Z</updated>
    <generator>https://github.com/jpmonette/feed</generator>
    <link rel="alternate" href="https://developer.holidu.com/changelog"/>
    <subtitle>Holidu developer hub Blog</subtitle>
    <icon>https://developer.holidu.com/ds/holidu-icon.svg</icon>
    <entry>
        <title type="html"><![CDATA[📈 Digest into multi-rates in Holidu API!]]></title>
        <id>https://developer.holidu.com/changelog/digest-into-multi-rates-in-holidu-api</id>
        <link href="https://developer.holidu.com/changelog/digest-into-multi-rates-in-holidu-api"/>
        <updated>2025-04-07T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Multi-rates in Holidu API v2.0]]></summary>
        <content type="html"><![CDATA[<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="multi-rates-in-holidu-api-v20">Multi-rates in Holidu API v2.0<a href="https://developer.holidu.com/changelog/digest-into-multi-rates-in-holidu-api#multi-rates-in-holidu-api-v20" class="hash-link" aria-label="Direct link to Multi-rates in Holidu API v2.0" title="Direct link to Multi-rates in Holidu API v2.0" translate="no">​</a></h2>
<p>New feature available in our API!</p>
<div class="theme-admonition theme-admonition-info admonition_xJq3 alert alert--info"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span>We’re excited to introduce a new functionality: multi-rates!</div><div class="admonitionContent_BuS1"><ul>
<li class="">You can now specify a Rate Identifier (<code>rateId</code>) in your requests to manage different rates (e.g., "Standard Rate", "Non-Refundable Rate") separately across apartments.</li>
<li class="">The <code>rateId</code> parameter is a string field used across multiple parts of our API:
<ul>
<li class="">LOS (Length of Stay)</li>
<li class="">Payment Configuration</li>
<li class="">Cancellation conditions</li>
</ul>
</li>
</ul></div></div>
<br>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="-summary-why-use-multi-rates">⚡ Summary: Why use multi-rates?<a href="https://developer.holidu.com/changelog/digest-into-multi-rates-in-holidu-api#-summary-why-use-multi-rates" class="hash-link" aria-label="Direct link to ⚡ Summary: Why use multi-rates?" title="Direct link to ⚡ Summary: Why use multi-rates?" translate="no">​</a></h2>
<ol>
<li class="">Manage twopricing models (e.g., refundable vs non-refundable) separately.</li>
<li class="">Delete, update, or retrieve LOS, payment settings and cancellation conditions per rate.</li>
<li class="">Keep your apartment’s pricing structure more flexible and organized.</li>
</ol>
<br>
<div class="theme-admonition theme-admonition-danger admonition_xJq3 alert alert--danger"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 12 16"><path fill-rule="evenodd" d="M5.05.31c.81 2.17.41 3.38-.52 4.31C3.55 5.67 1.98 6.45.9 7.98c-1.45 2.05-1.7 6.53 3.53 7.7-2.2-1.16-2.67-4.52-.3-6.61-.61 2.03.53 3.33 1.94 2.86 1.39-.47 2.3.53 2.27 1.67-.02.78-.31 1.44-1.13 1.81 3.42-.59 4.78-3.42 4.78-5.56 0-2.84-2.53-3.22-1.25-5.61-1.52.13-2.03 1.13-1.89 2.75.09 1.08-1.02 1.8-1.86 1.33-.67-.41-.66-1.19-.06-1.78C8.18 5.31 8.68 2.45 5.05.32L5.03.3l.02.01z"></path></svg></span>Important:</div><div class="admonitionContent_BuS1"><p>:ballot_box_with_check: If no <code>rateId</code> is passed, the request operates on the <strong>default rate</strong>.</p><p>:ballot_box_with_check: <code>rateId</code> must be a string of either <code>REFUNDABLE</code> or <code>NON_REFUNDABLE</code> and should be consistently used across different API calls for the same rate.</p><p>:ballot_box_with_check: Product design is currently supporting two rates per listings, so please set-up only:</p><ul>
<li class="">one flexible rate (with free-cancellation)</li>
<li class="">one non-refundable rate (without free cancellation)</li>
</ul></div></div>
<p>Please find here the <a class="" href="https://developer.holidu.com/docs/length-of-stay-los#using-rateid-with-los-length-of-stay">Holidu API V2 LOS</a> on how to set up a use <code>rateId</code> in LOS along with <a class="" href="https://developer.holidu.com/docs/payment-configuration#using-rateid-with-payment-configuration">Holidu API V2 Payment configuration</a> in payment configuration and <a class="" href="https://developer.holidu.com/docs/cancellation-conditions#using-rateid-with-cancellation-conditions">Holidu API V2 Cancellation conditions</a> in cancellation conditions.</p>
<p>If you are interested and still have some question, feel free to reach out to</p>
<p>or your Technical Account Manager.</p>]]></content>
        <author>
            <name>Piotr Tutaj</name>
        </author>
    </entry>
    <entry>
        <title type="html"><![CDATA[Check out our newly added feature - Booking lead time]]></title>
        <id>https://developer.holidu.com/changelog/draft-check-out-our-newly-added-feature-booking-lead-time</id>
        <link href="https://developer.holidu.com/changelog/draft-check-out-our-newly-added-feature-booking-lead-time"/>
        <updated>2024-06-07T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[We are excited to introduce a new field to our API: leadTimeHours. This field enhances our booking capabilities by defining the minimum amount of hours before check-in that a booking can be generated.]]></summary>
        <content type="html"><![CDATA[<p>We are excited to introduce a new field to our API: <code>leadTimeHours</code>. This field enhances our booking capabilities by defining the minimum amount of hours before check-in that a booking can be generated.</p>
<p>How it works? If you set up a booking lead time of 24 hours, then the apartment will never be bookable less than 24 hours before check-in. The parameter <code>leadTimeHours</code> was added to the <a class="" href="https://developer.holidu.com/reference/upsertapartment">apartment endpoint</a>.</p>
<p>Please find here the <a class="" href="https://developer.holidu.com/docs/general-static-data">Holidu API V2 Apartments Guide</a> on how to set up a booking lead time for each apartment.</p>
<p>If you are interested, would be happy if you reached out to</p>
<p>or your Technical Account Manager.</p>]]></content>
        <author>
            <name>Marie-Lena Mayerhofer</name>
        </author>
    </entry>
    <entry>
        <title type="html"><![CDATA[Get ready to migrate to Holidu API V2!]]></title>
        <id>https://developer.holidu.com/changelog/hapi-version-1-is-deprecated</id>
        <link href="https://developer.holidu.com/changelog/hapi-version-1-is-deprecated"/>
        <updated>2023-11-27T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[With the release of Holidu API V2, there will be no new development planned for Holidu API V1 and we encourage you to upgrade to API version 2 as soon as possible.]]></summary>
        <content type="html"><![CDATA[<p>With the release of Holidu API V2, there will be no new development planned for Holidu API V1 and we encourage you to upgrade to API version 2 as soon as possible.</p>
<p>API version 2 includes a range of new features and improvements that will greatly enhance your experience with our platform. These new features include a granular endpoint for apartment management, an apartment validation endpoint, a more flexible discount model and more. See our <a class="" href="https://developer.holidu.com/docs/hapi-version-1-to-version-2-migration-guide">migration guide</a> to start migrating your integration to Holidu API V2 to start benefiting.</p>
<p>We understand that upgrading to a new API version can be a significant change, but we are here to support you every step of the way. If you have any questions or concerns, please don't hesitate to contact us.</p>
<p>If you are ready, would be happy if you reached out to</p>
<p>or your Technical Account Manager.</p>]]></content>
        <author>
            <name>Marie-Lena Mayerhofer</name>
        </author>
        <category label="deprecated" term="deprecated"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Holidu API V2 is Officially Released!]]></title>
        <id>https://developer.holidu.com/changelog/hapi-version-2-is-officially-released</id>
        <link href="https://developer.holidu.com/changelog/hapi-version-2-is-officially-released"/>
        <updated>2023-11-27T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[We are excited to announce the release of Holidu API version 2! This latest version includes a range of new features and enhancements that we believe will greatly improve your experience with our platform.]]></summary>
        <content type="html"><![CDATA[<p>We are excited to announce the release of Holidu API version 2! This latest version includes a range of new features and enhancements that we believe will greatly improve your experience with our platform.</p>
<p>We have given our best effort to improve our Holidu API for our partners, making it easy to update information, removing redundant fields, using simpler object structures, and much more:</p>
<p>One of the most significant changes in this release is the addition of a granular endpoint for apartment management. This new endpoint will give you more control over your apartment listings, allowing you to manage your information in a more efficient and accurate way.</p>
<p>Therefore you will benefit from a straightforward, clean, and simple Holidu API V2 making it fun to work with:</p>
<p>Another exciting new feature is the apartment validation endpoint. With this new endpoint, you'll be able to validate the status of your apartments and make sure all the information, such as availability for booking, is up-to-date and complete. If for any reason, your apartment becomes inactive, you can use the validation endpoint to quickly identify the reason and take the necessary steps to get it reactivated.</p>
<p>Further, Holidu API V2 allows you to activate and deactivate apartments effectively through our new activation and deactivation endpoints. This eliminates the need to push Updates regularly in order not to let apartments go offline. This will for sure help you save your resources!</p>
<p>We've also made significant improvements to our discount model, making it more flexible and customizable to meet your specific needs.</p>
<p>The booking notification body has been enhanced as well providing you and your customers with all relevant booking information (for instance we found an even more comprehensible way of transferring the extra cost of each booking).</p>
<p>In case of cancellations Holidu API V2 introduces an automated cancellation process, allowing partners to receive instant notifications about canceled bookings.</p>
<p>For easy and efficient testing, we have set up a SANDBOX environment to ensure an even more easy and quick integration process.</p>
<p>Lastly, query parameters such as providerApartmentId, and provider were removed from the request body, those will now always be part of the URL and never part of the body.</p>
<p>We hope you will enjoy these new features and find them helpful in managing your apartment listings on our platform. If you have any questions or feedback, please don't hesitate to contact us.</p>
<p>Please check out here our detailed <a class="" href="https://developer.holidu.com/docs/certification">Guides for Holidu API V2 Endpoints</a> on how to use Holidu API V2.</p>
<p>If you have any questions, please do reach out to</p>
<p>or your Technical Account Manager. We are happy to help you.</p>]]></content>
        <author>
            <name>Marie-Lena Mayerhofer</name>
        </author>
        <category label="added" term="added"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Let's enhance facilities!]]></title>
        <id>https://developer.holidu.com/changelog/lets-enhance-facilities</id>
        <link href="https://developer.holidu.com/changelog/lets-enhance-facilities"/>
        <updated>2023-11-27T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Very often guests choose their desired vacation apartment by the range of facilities offered! Therefore most filters on the Holidu's list page are based on facilities.]]></summary>
        <content type="html"><![CDATA[<p>Very often guests choose their desired vacation apartment by the range of facilities offered! Therefore most filters on the Holidu's list page are based on facilities.</p>
<p>In order to increase the performance it is important to us that we receive all facilities, that your apartments are offering to our fellow guests.</p>
<p>To ensure a various and valuable range of facility types to our mutual guest, we are taking the following steps:</p>
<p>Firstly we have added the "name" field. Here you can insert the raw facility names from your own system. Further, we have made the “type” not mandatory any longer and will take over the correct mapping of those facility names.</p>
<p>As a next step, of course, we plan to expand our facility type list if we miss facilities that we consider as value-adding to our guests. We want to learn from the facilities pushed by our partners and enrich our endpoint thereby.</p>
<p>So if you are interested in pushing all your facilities' names to help us enhance our list, please do not hesitate to do so. We would be happy if you reached out to</p>
<p>or your Technical Account Manager.</p>
<p>Please find below here the <a class="" href="https://developer.holidu.com/reference/updatefacilities">API Reference Facility Endpoint</a>.</p>]]></content>
        <author>
            <name>Marie-Lena Mayerhofer</name>
        </author>
        <category label="improved" term="improved"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Meet our enhanced Discount Endpoint!]]></title>
        <id>https://developer.holidu.com/changelog/our-new-discount-endpoint</id>
        <link href="https://developer.holidu.com/changelog/our-new-discount-endpoint"/>
        <updated>2023-11-27T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[In Holidu API V2 we now offer you 4 discount types to enable you to create the right discount structure that works for you.]]></summary>
        <content type="html"><![CDATA[<p>In Holidu API V2 we now offer you 4 discount types to enable you to create the right discount structure that works for you.</p>
<p>Whether you want to offer a discount for long stays, last minute, early bird bookings, or for bookings made from specific devices, in Holidu API V2 that is possible!</p>
<p>Please find here the <a class="" href="https://developer.holidu.com/docs/discounts-1">Holidu API V2 Discounts Guide</a> on how to create great new discounts for our fellow guests.</p>
<p>If you are interested, would be happy if you reached out to</p>
<p>or your Technical Account Manager.</p>]]></content>
        <author>
            <name>Marie-Lena Mayerhofer</name>
        </author>
        <category label="improved" term="improved"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Keep Your Apartment Information Accurate and Up-to-Date with Our New /validation Endpoint]]></title>
        <id>https://developer.holidu.com/changelog/keep-your-apartment-information-accurate-and-up-to-date-with-our-new-validation-endpoint</id>
        <link href="https://developer.holidu.com/changelog/keep-your-apartment-information-accurate-and-up-to-date-with-our-new-validation-endpoint"/>
        <updated>2023-02-08T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[We are excited to announce a new /validation endpoint in our version 2 API. We understand the importance of having accurate and up-to-date information for your apartments, which is why we have implemented this new feature.]]></summary>
        <content type="html"><![CDATA[<p>We are excited to announce a new <code>/validation</code> endpoint in our version 2 API. We understand the importance of having accurate and up-to-date information for your apartments, which is why we have implemented this new feature.</p>
<p>In the event that your apartment becomes inactive, the <code>/validation</code> endpoint will provide you with the specific reason why, so you can take the necessary steps to get it reactivated.</p>
<p>To use this new endpoint, simply make a GET request to <a class="" href="https://developer.holidu.com/reference/getapartmentvalidation">/validation</a>. The response will include the validation status of your apartment, along with any information that is missing or needs to be updated.</p>
<p>Check out our guide on possible error code you could encounter, as well as how to solve it <a class="" href="https://developer.holidu.com/docs/validation">here</a>.</p>
<p>We hope this new feature will improve your experience with our platform and make it even easier for you to manage your apartments. If you have any questions or feedback, please don't hesitate to reach out to us.</p>]]></content>
        <author>
            <name>Hans Kristanto</name>
        </author>
        <category label="added" term="added"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Holidu is in preparation for version 2 of the API.]]></title>
        <id>https://developer.holidu.com/changelog/announcing-preparation-for-version-2</id>
        <link href="https://developer.holidu.com/changelog/announcing-preparation-for-version-2"/>
        <updated>2022-03-02T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[To allow maximum compatibility and to avoid double work, we recommend to follow these guidelines already while working with version 1 of the API.]]></summary>
        <content type="html"><![CDATA[<p>To allow maximum compatibility and to avoid double work, we recommend to follow these guidelines already while working with version 1 of the API.</p>
<ul>
<li class="">make use of the granular endpoints like facilities, extra costs, photos, reviews, etc. and do not push everything through the apartment endpoint. In version 2 it will not be possible anymore to push everything through the apartment endpoint.</li>
<li class="">Do not push costs as part of facilities, this will not be supported in version 2 anymore. Only use the cost related field <em>inclusive</em> to indicate if it has to be paid, but push the cost through the extra cost endpoint.</li>
</ul>]]></content>
        <author>
            <name>Janosch Link</name>
        </author>
        <category label="improved" term="improved"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Welcome to the brand new developer hub]]></title>
        <id>https://developer.holidu.com/changelog/welcome-to-the-brand-new-developer-hub</id>
        <link href="https://developer.holidu.com/changelog/welcome-to-the-brand-new-developer-hub"/>
        <updated>2022-02-22T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Welcome to the brand new Holidu Developer Hub, the place to find all documentation, reference and help you need to use all of Holidu's APIs.]]></summary>
        <content type="html"><![CDATA[<p>🎉 Welcome to the brand new Holidu Developer Hub, the place to find all documentation, reference and help you need to use all of Holidu's APIs.</p>]]></content>
        <author>
            <name>Janosch Link</name>
        </author>
        <category label="improved" term="improved"/>
    </entry>
</feed>