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.

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.

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.

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

{
  "hotel_bathroom_details": {
    "shared_bathroom_state": "MISSING",
    "private_bathroom_state": "PRESENT",
    "private_bathroom_details": {
      "type": "EXTERNAL_BATHROOM",
      "location_type": "OTHER",
      "location_other": "outside of the room"
    },
    "number_of_bathrooms": 2
  }
}

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

The following is a response snippet with a success message:

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

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
  }
}

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.

{
  "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.

{
  "property_bathroom_details": {
    "bathrooms": [
      {
        "id": 4823,
        "bathroom_type": "PRIVATE",
        "bathroom_location": "ENSUITE",
        "hostel_bathroom_details": {
          "bathroom_facilities": [
            {
              "type": "SHOWER",
              "count": 1
            },
            {
              "type": "TOILET",
              "count": 1
            },
            {
              "type": "SINK",
              "count": 1
            },
            {
              "type": "TOILET_PAPER"
            },
            {
              "type": "SHAMPOO",
              "is_paid": false
            }
          ]
        }
      }
    ]
  }
}

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

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:[]

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

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

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)
• property_bathroom_details.bathrooms[*].bathroom_location is optional and if specified allowed options depends on unit_type (room_type) please refer to /meta endpoint to check bathroom_configurations[*].allowed_options

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:

• Property type HOSTEL only allows:
  • 0-1 private bathrooms
  • 0-5 shared bathrooms
• property_bathroom_details.bathrooms[*].hostel_bathroom_details.bathroom_facilities[*] requires at least 1 of [SHOWER, TOILET, SINK, BATH]
• property_bathroom_details.bathrooms[*].hostel_bathroom_details.bathroom_facilities[*].count required for [SHOWER, TOILET, SINK, BATH]
• property_bathroom_details.bathrooms[*].hostel_bathroom_details.bathroom_facilities[*].count only allowed for bathroom_facilities[*].type : [SHOWER, TOILET, SINK, BATH]
• property_bathroom_details.bathrooms[*].hostel_bathroom_details.bathroom_facilities[*].is_paid only allowed for bathroom_facilities[*].type : [SLIPPERS, TOOTHBRUSH, SHAMPOO, CONDITIONER, BODY_SOAP, TOWEL]
• For private bathrooms:
  • num_guests_with_access_type not allowed
  • gender not allowed
• For shared bathrooms:
  • num_guests_with_access_type required
  • gender required

The following table describes the response elements:

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.

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

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"
  }
}