Set house rules for a property

Specify the house rules for a property with the method below. You can only specify house rules for Booking Home property types.

Method and URL

POST https://supply-xml.booking.com/house-rules/properties/{property_id}

Request parameters

Parameter Description Type Required Notes
property_id The property for which you want to specify house rules. integer Required Must be one of the Booking Home types.

Request headers

Header Description Type Required Notes
Authorization Your Base-64 encoded username and password. string Required -

Request body

Field Description Type Required Notes
smoking_allowed Specifies whether smoking in the property is allowed (1) or not (0). int Optional Accepts: 0 (no), 1 (yes)
parties_allowed Specifies whether guests may have parties at the property (1) or not (0). int Optional Accepts: 0 (no), 1 (yes)
pets_allowed Specifies whether pets are allowed. string Optional Accepts: yes, no, on_request
pets_price_type Specifies whether charges apply for bringing pets (if allowed). string Required if pets_allowed is yes or on_request Accepts: free, charges_may_apply
quiet_hours_set Specifies whether the property has quiet hours (1) or not (0). int Optional Accepts: 0 (no), 1 (yes)
quiet_hours_start_time Quiet hours start time. string Optional Format: HH:00, where HH is 123.
quiet_hours_end_time Quiet hours end time. string Optional Format: HH:00, where HH is 123.

Sample request

POST /house-rules/properties/1234567
Host: supply-xml.booking.com
Authorization: Basic TWF0dGV...
Content-Type: application/json

{
    "parties_allowed": 0,
    "pets_allowed": "yes",
    "pets_price_type": "free",
    "smoking_allowed": 1,
    "quiet_hours_set": 1,
    "quiet_hours_start_time": "22:00",
    "quiet_hours_end_time": "8:00"
}

Sample response — Success

{
    "errors": [],
    "data": {
        "success": 1
    },
    "meta": {
        "ruid": "UmFuZG9tetc"
    },
    "warnings": []
}

Sample response — Incorrect property type

{
    "errors": [
        {
            "message": "This property is not eligible for house rules.",
            "code": "OPERATION_NOT_ALLOWED",
            "details": null
        }
    ],
    "data": {},
    "warnings": [],
    "meta": {
        "ruid": "UmFuZG9etc"
    }
}

Sample response — Invalid arguments

{
    "errors": [
        {
            "message": "Validation of quiet_hours_start_time failed.",
            "details": {
                "fields": "quiet_hours_start_time"
            },
            "code": "INVALID_ARGUMENT"
        }
    ],
    "meta": {
        "ruid": "UmFuZG9etc"
    },
    "data": {},
    "warnings": []
}

Response headers

Header Description Type Notes
RUID Response Unique IDentifier. string -

Response body

Field Description Type Notes
success Returned upon a successful request. int -

Response codes

Code Description Notes
400 Bad request. -
404 Resource not found. -