Skip to content
/
Manage room-level facilit...

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
Test static response
https://developers.booking.com/_mock/connectivity/docs/openapispecs/facilities-api/facilities-api-specification
Test using live endpoint
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

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

Retrieve room facilities set for a property.

Request

Retrieve the facility details for all the facility instances added to the rooms

Path
roomIdinteger(int64)required
Query
debugInfostring
Default "false"
curl -i -X GET \
  'https://developers.booking.com/_mock/connectivity/docs/openapispecs/facilities-api/facilities-api-specification/properties/{propertyId}/rooms/{roomId}?debugInfo=false'

Responses

OK

Bodyapplication/json
dataArray of objects(RoomFacility)
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
metaobject(ResponseMeta)
Response
application/json
{
  "data": [
    { … }
  ],
  "warnings": [
    { … }
  ],
  "errors": [
    { … }
  ],
  "meta": {
    "ruid": "string"
  }
}

Manage room-level facilities

Request

Add, modify or delete room-level facilities details for a property

Path
propertyIdinteger(int32)required
roomIdinteger(int64)required
Bodyapplication/jsonrequiredArray [
room_facility_idinteger(int32)required

Room Facility ID

statestringrequired

Is facility Present/Missing?

Enum"MISSING""PRESENT"
room_facility_instancesArray of objects(RoomFacilityInstance)

List of Room Facility Instances

room_facility_metaobject(RoomFacilityMeta)

DEBUG ONLY. Contains Room Facility meta

facilityMetaTypeobject(RoomFacilityMeta)

DEBUG ONLY. Contains Room Facility meta

]
curl -i -X PUT \
  'https://developers.booking.com/_mock/connectivity/docs/openapispecs/facilities-api/facilities-api-specification/properties/{propertyId}/rooms/{roomId}' \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "room_facility_id": 1,
      "state": "PRESENT"
    },
    {
      "room_facility_id": 3,
      "state": "MISSING"
    }
  ]'

Responses

OK

Bodyapplication/json
dataobject(SuccessObject)
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
metaobject(ResponseMeta)
Response
application/json
{
  "data": {
    "success": true
  },
  "warnings": [
    { … }
  ],
  "errors": [
    { … }
  ],
  "meta": {
    "ruid": "string"
  }
}

Manage bathrooms

Use the GET and the PUT endpoints to:

  • Retrieve room bathroom configuration
  • Add, modify or delete room-level bathroom information
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

About Try it

Learn how to effectively use the Try it feature in the Facilities API documentation.

Use the Try it feature to send test request examples to the API endpoints directly from the developer portal and depending on the selected environment either see static, pre-built responses or dynamic responses from a test property.