Managing bathroom facilities

Use the bathroom endpoints in the Facilities API to manage bathroom facilities in a property.

You can:

• create, update or delete bathroom facilities.
• retrieve bathroom facility details for a property.

Create, update or delete bathroom details

PUT
https://supply-xml.booking.com/facilities-api/properties/{propertyId}/rooms/{roomId}/bathrooms

When creating or updating a bathroom facility, the request body differs based on whether the property is one of the following types:

• Hotels
• Homes
• Hostels

For example, Apartment is classified as a Homes property type. To determine whether a property is classified as a hotel or home and get their respective OTA and Booking.com property codes, see Booking.com property codes.

Managing Hotel bathroom facilities

When creating, updating or deleting bathroom facilities for properties that are categorised as Hotels, consider the following:

• You cannot edit specific bathrooms using IDs because you cannot create multiple bathroom instances.
• You can select only two bathroom states:
  • shared_bathroom_state (PRESENT or MISSING)
  • private_bathroom_state (PRESENT or MISSING)
• Specify the total number of bathrooms attached to the room using hotel_bathroom_details.number_of_bathrooms.

Path parameters

The following table describes the elements you must specify in the path:

Request body example

{
  "property_bathroom_details": {
    "bathrooms": [
      {
        "bathroom_type": "PRIVATE",
        "bathroom_location": "ENSUITE"
      },
      {
        "bathroom_type": "SHARED",
        "bathroom_location": "OPPOSITE_THE_ROOM"
      }
    ]
  }
}

For more examples, see the Bathrooms Open API specification under the Try it section.

Response body example

The following is a response snippet with a success message:

{
  "data": {
    "success": true
  },
  "warnings": [],
  "errors": [],
  "meta": {
    "ruid": "g497d724-54bb-4b48-8274-fafb59le127"
  }
}

Delete all Hotel bathrooms

To delete all bathroom facilities for a hotel:

• Set both hotel_bathroom_details.shared_bathroom_state and hotel_bathroom_details.private_bathroom_state to MISSING.
• Set hotel_bathroom_details.number_of_bathrooms to 0.

For example:

{
  "hotel_bathroom_details": {
    "shared_bathroom_state": "MISSING",
    "private_bathroom_state": "MISSING",
    "number_of_bathrooms": 0
  }
}

Managing Homes and Hostel bathroom facilities

When creating or updating bathroom facilities for properties that are categorised as Homes and Hostels, consider the following:

• You can create multiple bathroom instances.
• If bathrooms[0].id:{{ID}} is specified, then the endpoint updates the specified bathroom corresponding to the ID.
• If bathrooms[].id is not specified, then the endpoint creates a new bathroom.

Request body example

{
  "property_bathroom_details": {
    "bathrooms": [
      {
        "bathroom_type": "PRIVATE",
        "bathroom_location": "ENSUITE"
      },
      {
        "bathroom_type": "SHARED",
        "bathroom_location": "OPPOSITE_THE_ROOM"
      }
    ]
  }
}

For more request body examples, see the Bathrooms Open API specification under the Try it section.

Deleting a Home bathroom facility

Note that the endpoint deletes any missing bathroom configuration in the request body. For example, if bathrooms[0].id:12345 is missing from the payload, then the endpoint deletes the bathroom facility with the ID 12345.

To delete all bathrooms: Provide an empty list in the payload. For example, property_bathroom_details.bathrooms:[]

Bathroom validation rules

This section lists the validation rules you should keep in mind when managing bathroom facilities.

Validations when managing bathroom facilities for Hotels

Make sure to specify the following required fields:

• hotel_bathroom_details
• hotel_bathroom_details.shared_bathroom_state: [PRESENT | MISSING]
• hotel_bathroom_details.private_bathroom_state: [PRESENT | MISSING]
• hotel_bathroom_details.number_of_bathrooms

Constraints:

• The number_of_bathrooms must be within (0-20)
• If bathroom_state is all MISSING, number_of_bathrooms should be 0
• If bathroom_state contains PRESENT, number_of_bathrooms should be > 0

Validations when managing bathroom facilities for Homes

Make sure to specify the following required fields:

• property_bathroom_details
• property_bathroom_details.bathrooms[*].bathroom_type: [SHARED | PRIVATE]
• property_bathroom_details.bathrooms[].size: must be (0-20)

Validations when managing bathroom facilities for Hostels

Make sure to specify the following required fields:

• property_bathroom_details
• property_bathroom_details.bathrooms[*].bathroom_type: [SHARED | PRIVATE]
• property_bathroom_details.bathrooms[*].bathroom_location: [ENSUITE | NEXT_DOOR | DOWN_THE_HALL | OPPOSITE_THE_ROOM | IN_THE_HALLWAY | OTHER]
• property_bathroom_details.bathrooms[*].hostel_bathroom_details
• property_bathroom_details.bathrooms[*].hostel_bathroom_details.bathroom_facilities[*]

Constraints:

• For private bathrooms:
  • bathroom_location must be [ENSUITE]
• For shared bathrooms:
  • bathroom_location must be [NEXT_DOOR | DOWN_THE_HALL | OPPOSITE_THE_ROOM | IN_THE_HALLWAY | OTHER]
  • bathrooms[].hostel_bathroom_details.bathroom_facilities[] requires at least 1 of [SHOWER, TOILET, SINK, BATH] with count > 0
  • bathrooms[].hostel_bathroom_details.bathroom_facilities[].count required for [SHOWER, TOILET, SINK, BATH]
• For private bathrooms:
  • num_guests_with_access_type not allowed
  • gender not allowed
• For shared bathrooms:
  • num_guests_with_access_type required
  • gender required
  • bathroom_facilities[] type not allowed: is_paid option. Allowed types with is_paid options: [SLIPPERS, TOOTHBRUSH, SHAMPOO, CONDITIONER, BODY_SOAP, TOWEL]
• Property type HOSTEL only allows:
  • 0-1 private bathrooms
  • 0-5 shared bathrooms

Request body parameters

Response body elements

The following table describes the response elements:

Retrieve bathroom facility details

GET
https://supply-xml.booking.com/facilities-api/properties/{propertyId}/rooms/{roomId}/bathrooms

Use this endpoint to retrieve the bathroom facilities for the specified listing.

Path parameters

The following table describes the elements you must specify in the path:

Response body example

The following is a response body snippet:

{
  "data": {
    "property_bathroom_details": {
      "bathrooms": [
        {
          "id": 325662717,
          "bathroom_type": "PRIVATE",
          "bathroom_location": "ENSUITE"
        },
        {
          "id": 325662718,
          "bathroom_type": "SHARED",
          "bathroom_location": "OPPOSITE_THE_ROOM"
        }
      ]
    }
  },
  "warnings": [],
  "errors": [],
  "meta": {
    "ruid": "94kk241-149f-4ec5-8632-3035cfb1l9b4"
  }
}

Response parameters