Enquiries Channel manager Bookings Your website Booking engine Pricing Log in Sign up
v2026-09

restrictions.changed

Stay rules, and which of them Doorloom actually enforces.

When it fires

The property's booking rules changed, or a per-date minimum or maximum stay or stop-sell changed.

This event is date-scoped: it carries a window, and data.dates[] has one entry per night in that window, inclusive of both ends. A window never spans more than one calendar month, so a change across a longer range arrives as several events.

What to do with it

  • On the brand's own website, Doorloom enforces property_rules and the per-date min_nights at guest checkout. A stay must meet the highest minimum among its nights, where a night's minimum is its dates[].min_nights, else property_rules.min_nights, else 1. The per-date max_nights is advisory: it is shown to the host and pushed to channel managers, and nothing enforces it.
  • None of these rules are applied to POST /bookings. A booking you send is checked for availability only, so a stay shorter than the minimum is accepted. Apply the rules on your side before you take the booking.
  • property_rules is null when the host has set no rules. No row means no rule, not a rule of zero. A per-date min_nights still applies on its own.
  • Advance notice has two forms. When advance_booking_hours is set it is the rule, measured back from the check-in date at the property's check-in time, and advance_booking_days and same_day_cutoff_time are not applied. When it is null, the days rule and the same-day cutoff apply.
  • stop_sell is the flag to push to an OTA. It is true when the night is blocked, or when the host blocked it everywhere.

The data block

Field Type Description
property_rules object|null Property-wide booking rules, enforced at guest checkout on the brand's website. Null when unset.
property_rules.min_nights integer Shortest stay the property accepts, unless a night carries its own dates[].min_nights.
property_rules.max_nights integer Longest stay the property accepts. 0 means no limit.
property_rules.advance_booking_days integer How many days ahead a booking must be made. Applied only when advance_booking_hours is null.
property_rules.advance_booking_hours integer|null Minimum notice in hours before check-in: 1 to 24, 48, 72 or 168. Null means the days rule applies instead.
property_rules.same_day_cutoff_time string|null H:i in Asia/Kolkata. After this, same-day bookings are refused. Null means no cutoff. Applied only when advance_booking_hours is null and advance_booking_days is 0.
dates[].date string Y-m-d.
dates[].min_nights integer|null Per-date minimum stay. Enforced at guest checkout on the brand's website; it overrides property_rules.min_nights for that night, and may be lower. Null means the property rule applies.
dates[].max_nights integer|null Per-date maximum stay. Advisory.
dates[].block_scope string|null null, "ota_only" or "everywhere".
dates[].stop_sell boolean True when the night is blocked or scoped everywhere. This is what you push to an OTA.

Example

The full envelope, as it arrives on the wire.

json
{
    "id": "01J6Y0S5N8Q1R4T6V8X0Z2A4B6",
    "type": "restrictions.changed",
    "version": "2026-09",
    "sequence": 1044,
    "occurred_at": "2026-10-01T09:34:11+00:00",
    "integration": {
        "id": 12,
        "slug": "acme-pms"
    },
    "property": {
        "doorloom_id": 902,
        "external_id": "VILLA-9",
        "master_property_id": 902
    },
    "window": {
        "from": "2026-10-12",
        "to": "2026-10-14"
    },
    "data": {
        "property_rules": {
            "min_nights": 2,
            "max_nights": 14,
            "advance_booking_days": 1,
            "advance_booking_hours": 24,
            "same_day_cutoff_time": "18:00"
        },
        "dates": [
            {
                "date": "2026-10-12",
                "min_nights": 2,
                "max_nights": null,
                "block_scope": null,
                "stop_sell": false
            },
            {
                "date": "2026-10-13",
                "min_nights": 3,
                "max_nights": null,
                "block_scope": null,
                "stop_sell": false
            },
            {
                "date": "2026-10-14",
                "min_nights": null,
                "max_nights": null,
                "block_scope": "everywhere",
                "stop_sell": true
            }
        ]
    }
}

Related

Something unclear or wrong on this page? Write to [email protected] and tell us which page — we would rather fix the doc than answer the ticket twice.