Discounts

You can use the discounts endpoint to add multiple discounts per apartment. There is no possibility to push discounts for all of your properties at the same time, you will always need to add the discounts individually to every apartment.

The following discount types are supported: "LAST_MINUTE", "EARLY_BIRD", "LONG_STAY" and "DEVICE_SPECIFIC"

You can always check for active discounts for a specific apartment using the GET Discounts endpoint or GET a single discount for an apartment by discount id

The discount object

Status of a discount

Type of a discount

❗

Be aware

• Discounts should be properly used for actual discounts, not for missing rates in LOS file
• The discount will always be applied to the whole base rate of the property if those conditions apply, not just to the specific days
• If you push more than 1 discounts for each booking only 1 discount object will be applied. The one leading to the highest discounted amount will be applied.

Examples

Create a discount for Early Birds

If a guest is an early bird and books for 5 nights or more and 90 days or more before check-in date the price per night is discounted by 10%.

{
  "discountPercent": 10,
  "status": "ACTIVE",
  "discountType": "EARLY_BIRD",
  "conditions": {
    "daysBeforeCheckIn": 90,
    "minStay": 5
  }
 
}

Create a discount for Last Minute guests

If a guest likes to book last minute 7 days or less before check-in date the price per night is discounted by 20%.

{
  "discountPercent": 20,
  "status": "ACTIVE",
  "discountType": "LAST_MINUTE",
  "conditions": {
    "daysBeforeCheckIn":7
  }
 
}

Create a discount for Long Stays

If a guest chooses to stay 7 or more days the price is discounted by 20% for bookings if the guests books between 2023-08-01 and 2021-04-30

{
  "discountPercent": 20,
  "status": "ACTIVE",
  "discountType": "LONG_STAY",
  "conditions": {
    "bookingSeason": [
      {
        "onlyApplicableFrom": "2020-08-01",
        "onlyApplicableUntil": "2021-04-30"
      }
    ],
    "minStay": 7
  }
}

Create a discount for a device specific booking

If a guest chooses to book on a mobile device the price is discounted by 15% if the guest's travel date is between 2023-08-01 and 2021-04-30

{
  "discountPercent": 15,
  "status": "ACTIVE",
  "discountType": "DEVICE_SPECIFIC",
  "conditions": {
    "travelSeason": [
      {
        "onlyApplicableFrom": "2020-08-01",
        "onlyApplicableUntil": "2021-04-30"
      }
    ],
    "deviceType": "MOBILE"
  }
}

Update an existing discount to status deleted

💡Now the "id" needs to be included in the request. To get all pushed discount objects including the discount id you can use the GET

{
  "id": 123,
  "discountPercent": 20,
  "status": "DELETED",
  "discountType": "DEVICE_SPECIFIC",
  "conditions": {
    "deviceType": "DESKTOP"
  }
  
}

Update an existing discount to status inactive

💡Now the "id" needs to be included in the request. To get all pushed discount objects including the discount id you can use the GET

{
   "id":456,
   "discountPercent":20,
   "status":"INACTIVE",
   "discountType":"LONG_STAY",
   "conditions":{
      "minStay":14,
      "travelSeason":[
         {
            "onlyApplicableFrom":"2024-05-01",
            "onlyApplicableUntil":"2024-09-30"
         }
      ]
   }
}