Room Deactivate API

This endpoint is used to deactivate a room listing by providing the channel_room_id associated with the room.

NOTE

Once you deactivate the room then after you will not be able to activate that room.

This API call allows you to remove a room's availability from the platform, which may be necessary when the room is no longer available for booking or if it is being temporarily deactivated for maintenance or other reasons.

---

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/room/deactive

Header

-app-id: YOUR_APP_ID
Authorization: YOUR_API_KEY
Content-Type:application/json

Header	Type	Required	Description
app-id	string	Yes	Your application ID. Required for authentication.
Authorization	string	Yes	Your API key. for authorization. Required for authentication.
Content-Type	string	Yes	Must be set to application/json.

---

Attributes

hotel_id string (Required)

Specifies the hotel ID for the property.

---

channel_hotel_id string (Required)

Specifies the channel-specific hotel ID for the property.

---

channel_room_id string (Required)

Specifies the channel-specific room ID for the property.

---

Sample Request

{
   "hotel_id": "new1",
   "channel_hotel_id": "12915674",
   "channel_room_id": "1291567402"
}

---

Response

Sample Success Response

{
   "Status": "Success",
   "Data": [],
   "Message": "Room Deactivate Successfully",
   "Ruid": "90cd648f-766f-47a1-991d-7861f43e6361"
}

Success Response Body Elements

Status string

Indicates the result of the API call.

Will be "Success" for successful operations.

---

Data object

An object containing data related to the successful image creation. This typically includes identifiers for the created images.

---

Message string

A message receives within the response body. This will generally be an empty string if no additional information is needed.

---

Ruid string

Specifies the unique request ID.

You can share this ID with Booking.com customer support when you run into an issue. This can help in understanding what went wrong.

Errors

Sample Error Response 1

{
   "Errors": [
       {
           "Code": "400",
           "ShortText": "HotelCode: Invalid HotelCode ('NT711')"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 2

{
   "Errors": [
       {
           "Code": "573",
           "ShortText": "channel-mapping not found for this property!"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 3

When you pass invalid channel_room_id then booking.com will raised error in this format:

{
   "Status": "Fail",
   "Errors": [],
   "Message": "Invalid value: listingId not found",
   "Ruid": "7df7b195-0258-45fe-95ef-87fb3f2f8a96"
}

---

Error Response Body Elements

Status string

Indicates the result of the API call, which will be always "Fail" in case of an error response.

---

Error array

Array that contains details about any errors that occurred during the API call. Each object in the Errors array contains the following properties:

Code string

Specific error code that helps identify the type of error.

For example: "400" indicates a bad request.

ShortText string

A short description of the error.

---

Message string

A message providing more information about the error.

---

Ruid string

A unique identifier for tracking the request.