Documentation
Documentation
Home

Seasonal Pricing Rules

❗️

Length of Stay Pricing vs Seasonal Pricing

You cannot not send any seasonal pricing data when using Length of Stay pricing. Your Length of Stay pricing should have your pricing rules baked into the matrix. Any seasonal pricing data sent will be ignored if already sending pricing through Length of Stay pricing.

Format

The format of seasonal pricing should be sent:

{
  "seasonalPricing": [
    {
      "startDate": "2022-12-01",
      "endDate": "2022-12-10",
      "nightlyPrice": 100,
      "weekendPrice": 100,
      "additionalGuestPrice": 0,
      "additionalGuestPriceAfter": 0,
      "lengthOfStayDiscounts": [
        {
          "lengthOfStay": 0,
          "discountPercentage": 0
        }
      ]
    },
    {
      "startDate": "2022-12-11",
      "endDate": "2022-12-31",
      "nightlyPrice": 100,
      "weekendPrice": 100,
      "additionalGuestPrice": 0,
      "additionalGuestPriceAfter": 0,
      "lengthOfStayDiscounts": [
        {
          "lengthOfStay": 2,
          "discountPercentage": 10
        },
        {
          "lengthOfStay": 5,
          "discountPercentage": 20
        },
        {
          "lengthOfStay": 10,
          "discountPercentage": 30
        }
      ]
    }
  ]
}

Rules & Examples

1. Gaps in seasons or a lack of pricing for dates will result in the listing showing as unavailable. Please do not use this as a way to send availability data. If we have not received pricing data but the listing has no blocked dates, we will assume this is a mistake and contact you.

For example, if you send the below JSON, the listing will show as unavailable from 2022-12-10 to 2022-12-20:

{
  "seasonalPricing": [
    {
      "startDate": "2022-12-01",
      "endDate": "2022-12-10",
      "nightlyPrice": 100,
      "weekendPrice": 100,
      "additionalGuestPrice": 0,
      "additionalGuestPriceAfter": 0,
      "lengthOfStayDiscounts": [
        {
          "lengthOfStay": 0,
          "discountPercentage": 0
        }
      ]
    },
    {
      "startDate": "2022-12-20",
      "endDate": "2022-12-31",
      "nightlyPrice": 100,
      "weekendPrice": 100,
      "additionalGuestPrice": 0,
      "additionalGuestPriceAfter": 0,
      "lengthOfStayDiscounts": [
        {
          "lengthOfStay": 2,
          "discountPercentage": 10
        },
        {
          "lengthOfStay": 5,
          "discountPercentage": 20
        },
        {
          "lengthOfStay": 10,
          "discountPercentage": 30
        }
      ]
    }
  ]
}

2. We do not support a default price, please send all pricing for all seasons.

3. We only support our payout currencies for Seasonal Pricing.

Our payout currencies are:

  • £ (GBP)
  • € (EUR)
  • $ (USD)
  • ₪ (ILS)
  • kr (DKK)
  • $ (AUD)
  • $ (NZD)

4. We define the weekend as a Friday or Saturday. Weekend prices will only be applied to nights on these days.

Example 4.1: Weekend Price

{
  "seasonalPricing": [
    {
      "startDate": "2022-12-01",
      "endDate": "2022-12-10",
      "nightlyPrice": 100,
      "weekendPrice": 200,
      "additionalGuestPrice": 0,
      "additionalGuestPriceAfter": 0,
      "lengthOfStayDiscounts": [
        {
          "lengthOfStay": 0,
          "discountPercentage": 0
        }
      ]
    }
}

A booking is made for 2022-12-01 (Thursday) to 2022-12-05 (Monday). The price is as follows:
2022-12-01: £100
2022-12-02: £200
2022-12-03: £200
2022-12-04: £100