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 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 1 –23 . |
quiet_hours_end_time |
Quiet hours end time. |
string |
Optional |
Format: HH:00 , where HH is 1 –23 . |
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 body
Field |
Description |
Type |
Notes |
success |
Returned upon a successful request. |
int |
- |
Response codes
Code |
Description |
Notes |
400 |
Bad request. |
- |
404 |
Resource not found. |
- |
Is this page helpful?
Yes |
No
Thanks for your feedback!