Get Disconnection Summaries
This endpoint allows you to retrieve detailed information about service disconnections for one or multiple properties connected through Booking.com.
Endpoint
POST
https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/connection/getDisconnectionSummariesHeader
-app-id: YOUR_APP_ID
Authorization: YOUR_API_KEY
Content-Type:application/jsonapp-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.
Sample Request 1
Get Disconnection detail for specific property
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.
{
"hotel_id": "new1",
"channel_hotel_id": "12915670"
} Response
Sample Success Response 1
{
"Status": "Success",
"Data": {
"deactive_connection_data": [
{
"property_id": 12915670,
"connection_types": {
"CONTENT": "2025-01-25T10:28:05Z",
"REVIEWS": "2025-01-25T10:28:05Z",
"REPORTING": "2025-01-25T10:28:05Z",
"PERFORMANCE": "2025-01-25T10:28:05Z",
"AVAILABILITY": "2025-01-25T10:28:05Z",
"PHOTOS": "2025-01-25T10:28:05Z",
"MESSAGING": "2025-01-25T10:28:05Z",
"RESERVATIONS": "2025-01-25T10:28:05Z"
},
"fully_disconnected": true,
"last_disconnected_at": "2025-01-25T10:28:05Z"
}
],
"other_data": {
"Next_Count": 0,
"Previous_Count": 0
}
},
"Message": "Disconnection Summaries Details Fetch Successfully",
"Ruid": "ee1658dc-fa1d-473e-970b-ee8f1aba2403"
} 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 Request 2
Get Disconnection detail for All property
Attributes
start_time string (Required)
Defines the beginning of the time range for fetching disconnection data.
end_time string (Optional)
Filters results to include properties with the specified disconnection type.
disconnection_type string (Optional)
Filters results to include properties with the specified disconnection type.
page_size integer (Optional)
Specifies the maximum number of records to return in one page. Useful for paginated responses.
cursor string (Optional)
Cursor token for pagination. Used to fetch the next/previous set of results.
order_by string (Optional)
Defines the sorting order of the results.
Get Disconnection detail for All property
{
"parameters": {
"start_time": "2024-01-07T10:00:00Z",
"end_time": "2025-01-07T10:00:00Z",
"disconnection_type": "full",
"page_size": 1,
"cursor": "AAAMNOBoyhgCBCAAAGIfgOE",
"order_by": "last_disconnected_at"
}
} Response
Status string
Indicates whether the request was successful or failed.
Possible values: "Success" or "Fail".
Data object
Holds the main content of the response, including disconnected property details and pagination information.
Data.deactive_connection_data array
A list containing details of each disconnected property that matched the request.
Data.deactive_connection_data[].property_id integer
The unique identifier for the property on the connected channel, such as Booking.com.
Data.deactive_connection_data[].connection_types object
A list of services that were disconnected for the property. Each service is paired with the timestamp when it was disconnected.
Data.deactive_connection_data[].fully_disconnected boolean
Shows whether all services for the property were disconnected.
Possible values: true or false.
Data.deactive_connection_data[].last_disconnected_at string
The date and time when the most recent disconnection occurred.
Data.other_data object
Provides additional details such as pagination counters for the result set.
Data.other_data.Next_Count integer
The number of records that are available on the next page of results.
Data.other_data.Previous_Count integer
The number of records that are available on the previous page of results.
Message string
A human-readable message describing the result of the API request.
Ruid string
A unique identifier for the request, used for logging, troubleshooting, or support tracking.
Sample Success Response 1
{
"Status": "Success",
"Data": {
"deactive_connection_data": [
{
"property_id": 10881804,
"connection_types": {
"REVIEWS": "2023-10-16T14:38:53Z",
"RESERVATIONS": "2023-10-16T14:38:53Z",
"ONLINECHECKIN": "2023-10-16T14:38:53Z",
"CONTENT": "2023-10-16T14:38:53Z"
},
"fully_disconnected": true,
"last_disconnected_at": "2023-10-16T14:38:53Z"
},
{
"property_id": 10744112,
"connection_types": {
"AVAILABILITY": "2023-10-26T15:22:25Z",
"PHOTOS": "2023-10-26T15:22:25Z",
"REVIEWS": "2023-10-26T15:22:25Z",
"MESSAGING": "2023-10-26T15:22:25Z",
"REPORTING": "2023-10-26T15:22:25Z",
"RESERVATIONS": "2023-10-26T15:22:25Z",
"ONLINECHECKIN": "2023-10-26T15:22:25Z",
"CONTENT": "2023-10-26T15:22:25Z"
},
"fully_disconnected": true,
"last_disconnected_at": "2023-10-26T15:22:25Z"
},
{
"property_id": 331344,
"connection_types": {
"AVAILABILITY": "2023-12-03T22:27:04Z",
"PHOTOS": "2023-12-03T22:27:04Z",
"REVIEWS": "2023-12-03T22:27:04Z",
"MESSAGING": "2023-12-03T22:27:04Z",
"REPORTING": "2023-12-03T22:27:04Z",
"RESERVATIONS": "2023-12-03T22:27:04Z",
"ONLINECHECKIN": "2023-12-03T22:27:04Z",
"CONTENT": "2023-12-03T22:27:04Z"
},
"fully_disconnected": true,
"last_disconnected_at": "2023-12-03T22:27:04Z"
},
{
"property_id": 2738594,
"connection_types": {
"AVAILABILITY": "2023-12-13T08:42:52Z",
"PHOTOS": "2023-12-13T08:42:52Z",
"REVIEWS": "2023-12-13T08:42:52Z",
"MESSAGING": "2023-12-13T08:42:52Z",
"REPORTING": "2023-12-13T08:42:52Z",
"CONTENT": "2023-12-13T08:42:52Z"
},
"fully_disconnected": true,
"last_disconnected_at": "2023-12-13T08:42:52Z"
},
{
"property_id": 10500711,
"connection_types": {
"AVAILABILITY": "2024-01-24T13:42:22Z",
"PHOTOS": "2024-01-24T13:42:22Z",
"REVIEWS": "2024-01-24T13:42:22Z",
"MESSAGING": "2024-01-24T13:42:22Z",
"REPORTING": "2024-01-24T13:42:22Z",
"ONLINECHECKIN": "2024-01-24T13:42:22Z",
"CONTENT": "2024-01-24T13:42:22Z"
},
"fully_disconnected": true,
"last_disconnected_at": "2024-01-24T13:42:22Z"
}
],
"other_data": {
"Next_Count": 771,
"Previous_Count": 0
}
},
"Message": "Disconnection Summaries Details Fetch Successfully",
"Ruid": "afa989da-153f-42cb-a4b0-9990ce1d2105"
} Success Response 2
{
"Status": "Success",
"Data": {
"other_data": {
"Next_Count": 771,
"Previous_Count": 0
}
},
"Message": "Disconnection Summaries Details Fetch Successfully",
"Ruid": "afa989da-153f-42cb-a4b0-9990ce1d2105"
} Error
Sample Error Response 1
When error was thrown from booking.com
{
"Status": "Fail",
"Errors": [],
"Message": "Access denied"
} 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.
Last updated
Was this helpful?