API Rates propvides information about discount rules a listing can have. There are 3 types of discounts: Longer stay, Early bird and Last minute.

  • Longer stay: There can be discount for stays of 7 nights or more, stays of 14 nights or more, stays of 21 nights or more, or stay of 28 nights or more.
    Longer stay discount might not be available for some specific period. In that case, information is given in longerStayExclusionPeriods
  • Early bird: Discount is available if booking is made more than x days before check-in.
  • Last minute: Discount is available if booking is made less than y days before check-in.

If more than one discount rule are valid at the time of booking, only one which gives more discount amount to guest will be applied. Check-in date is used to decide if a discount is applied.

Please note that discount value is given in percentage. Below is example of discount rules returned by the API. 

 "longerStay": {
        "7": 5,
        "14": 10,
        "21": 15,
        "28": 0
    },
 "longerStayExclusionPeriods": [
        {
            "startDate": "2020-10-17",
            "endDate": "2020-10-30"
        },
       {
            "startDate": "2021-05-01",
            "endDate": "2021-05-30"
        }
    ],
"earlyBird": {
        "120": 10
    },
"lastMinute": {
        "7": 4
    }

In this example, listing has the following rules:

  • 5% discount for stays of 7 nights or more
  • 10% discount for stays of 14 nights or more
  • 15% discount for stays of 21 nights or more
  • Longer stay discount cannot be applied if check-in is in periods (2020-10-17, 2020-10-30), (2021-05-01, 2021-05-30)
  • 10% discount if booking is made more than 120 days before check-in
  • 4% discount of booking is made less than 7 days before check-in