Deactivate Connection

This endpoint allows you to deactivate the connection for a specific property on a connected channel by providing the property’s hotel ID and channel-specific hotel ID.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/connection/deactivateConnection

---

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 required for authorization.
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.

---

Sample Request

{
  "hotel_id": "new1",
  "channel_hotel_id": "12915670"
}

---

Response

Attributes

Status string

Indicates the result of the API call.

For example, Success or Fail.

---

Data object

Contains the main response data, such as property connection details.

An empty array if no data is found.

---

Message string

Descriptive message summarizing the API operation's outcome.

For example:

Connection Deactivated Successfully, No Data Found

---

Ruid string

Unique request identifier for tracking, debugging, and logging.

---

Sample Success Response

{ 
   "Status": "Success", 
   "Data": [], 
   "Message": "Connection Deactivated Successfully", 
   "Ruid": "f4ef89ae-9de1-4eaa-bf74-10c05459b1f5" 
} 

---

Error

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 error was thrown from booking.com

{ 
   "Status": "Fail", 
   "Errors": [], 
   "Message": "Data not found: Connection not found", 
   "Ruid": "89c357b8-26e7-471b-9e13-fa9e8532a224" 
}

---

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.

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.