Unfortunately, this feature is not supported on mobile devices. For the best experience, please use a computer.

Facilities API (1.0)

Manage facilities at both the property- and room-level.\n Booking.com supports adding or assigning a variety of different facilities at the property- or room-level. Specify the facility ID along with any required parameters to assign a facility.\n\nFacilities are of the following types:

  • Single-instance facilities: You can assign these facilities only once to a property or a room. An example of a single-instance facility is: room service. There are two types of single-instance facilities:
    • Single-instance facilities that can be toggled on or off.
    • Single-instance facilities supporting optional parameters: Allows you to specify more details about the facility
  • Multi-instance facilities: You can assign multiple facilities of this type to a property. When adding multi-instance facilities you must provide additional details to add to a property or a room. Examples of multi-instance facilities are: Restaurant, Swimming pool and Parking.
Download OpenAPI description
facilities-api-specification.json
facilities-api-specification.yaml
Overview
URL https://connect.booking.com
Connectivity Team connectivity@booking.com
Languages
Servers
https://supply-xml.booking.com/facilities-api/

Manage property facilities

Use the GET and the PUT endpoints to:

  • Retrieve property-level facilities details
  • Add, modify or delete property-level facilities details
    • Add single-instance facilities
    • Add multi-instance facilities
Operations

Meta data endpoint

Retrieve the latest facility definitions.

  • Get the list of all supported facilities
    • To get the details of a property-level facility: Look for a matching name under the facility_name in the response. To add this facility, you must specify the facility_id. Property-level facilities are listed under the property_facility_metas in the meta endpoint response.
    • To get the details of the room-level facility: Look for a matching name under the room_facility_name in the response. To add the facility, you must specify the room_facility_id. Room-level facilities are listed under the room_facility_metas in the meta endpoint response.
  • Details of the facilities such as ID, OTA code and any optional parameters.
Operations

Manage room facilities

Use the GET and the PUT endpoints to:

  • Retrieve room facilities set for a property.
  • Add, modify or delete room facilities.
Operations

Manage bathrooms

Operations

Retrieve room bathroom configuration

Request

Retrieve room bathroom configuration. Bathroom attached to rooms.

Path
propertyIdinteger(int32)required
roomIdinteger(int64)required
curl -i -X GET \
  'https://supply-xml.booking.com/facilities-api/properties/{propertyId}/rooms/{roomId}/bathrooms'
Experience it firsthand in the API Explorer!

Responses

OK

Body*/*
dataobject(BathroomDetails)
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
metaobject(ResponseMeta)

Manage bathrooms

Request

Add, modify or delete room-level bathroom information

Path
propertyIdinteger(int32)required
roomIdinteger(int64)required
Bodyapplication/jsonrequired
property_bathroom_detailsobject(PropertyBathroomDetails)
hotel_bathroom_detailsobject(HotelBathroomDetails)
curl -i -X PUT \
  'https://supply-xml.booking.com/facilities-api/properties/{propertyId}/rooms/{roomId}/bathrooms' \
  -H 'Content-Type: application/json' \
  -d '{
    "hotel_bathroom_details": {
      "shared_bathroom_state": "PRESENT",
      "private_bathroom_state": "PRESENT",
      "number_of_bathrooms": 3
    }
  }'
Experience it firsthand in the API Explorer!

Responses

OK

Body*/*
dataobject(SuccessObject)
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
metaobject(ResponseMeta)