Length of Stay (LoS) Pricing Rules

Format

The format of LoS pricing is as follows and should be delivered in CSV format:

CheckInGuestsLos1PriceLos2PriceLos3Price...Los7Price...Los730Price
2022-12-20420000400006000014000014600000
2023-03-014006000014000014600000

Prices

Each price is the total for the whole stay, as a whole number in the smallest unit of the currency. For GBP that is pence, so £200 is 20000. Decimals, negative numbers and thousands separators are not accepted.

Rules & Examples

1. A price of 0 indicates no availability.

For example, if there was a booking from 1/12/2022 to 3/12/2022 for a home priced at £200/night, the table would look like this for the first week of December 2022 (assuming no other pricing or availability rules):

CheckInGuestsLos1PriceLos2PriceLos3Price...Los7Price
2022-12-0140000
2022-12-0240000
2022-12-034200004000060000140000
2022-12-044200004000060000140000
2022-12-054200004000060000140000
2022-12-064200004000060000140000
2022-12-074200004000060000140000

2. The matrix should contain all pricing possibilities. We will not add any discounts or pricing rules to the price stated in the matrix except for tax.

Example 2.1: Additional Guests

Additional Guests: If pricing is higher with 5 guests, a second set of data would be expected with the prices for 5 guests. For example, using the table in the format section, if the price of an additional guest above 4 guests is £50 / night, the matrix should be changed to look like so:

CheckInGuestsLos1PriceLos2PriceLos3Price...Los7Price
2022-12-204200004000060000140000
2022-12-205250005000075000175000
2023-03-0140060000140000
2023-03-0150075000175000

Example 2.2: Length of Stay Discount

Length of Stay Discount: If you have a discount on stays of a certain length, then this must be included in the matrix. For example, if the price of an additional guest above 4 guests is £50 / night and a stay of 7 nights gets a 10% discount then the matrix would like so:

CheckInGuestsLos1PriceLos2PriceLos3Price...Los7Price
2022-12-204200004000060000126000
2022-12-205250005000075000157500
2023-03-0140060000126000
2023-03-0150075000157500

3. The matrix should contain all availability possibilities. We will not apply any additional availability rules to the matrix.

Example 3.1: Minimum Night Stay

Minimum Night Stay: If you have a minimum night stay, then this must be included in the matrix. For example, if we use the table listed in the format section, and then apply a minimum night stay of 3 nights and no pricing rules, the matrix should look like so:

CheckInGuestsLos1PriceLos2PriceLos3Price...Los7Price
2022-12-2040060000140000
2023-03-0140060000140000

Example 3.2: Restricted Booking Window

Restricted Booking Window: If you have a Restricted Booking Window, then this must be included in the matrix. For example, if we apply a Restricted Booking Window of 1 day and apply no other availability or pricing rules, the matrix should look like so:

CheckInGuestsLos1PriceLos2PriceLos3Price...Los7Price
today404000060000140000
tomorrow4200004000060000140000

4. We can accept pricing up to 2 years in advance.

5. Do not send header rows. If you have less than 730 nights data, then send less columns.

6. We can accept any currency for LoS pricing.

7. Please include cleaning fees in the pricing matrix. Cleaning fees sent using the POST Cleaning Fee endpoint will be ignored.

Process Time

Due to the time taken to process a price matrix, this will not be a synchronous process. Your matrix will be accepted and processed asynchronously. We will not give a guaranteed time in which it will be processed and made available.