Property Status Closed

This endpoint is used to close a property temporarily, preventing it from appearing on Booking.com. The closure must include a reason (e.g., renovation, season, or fully booked) and a description of the reason.

---

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/property/status/verify

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.
Content-Type	string	Yes	Must be set to application/json.

---

Attributes

hotel_id string (Required)

The unique property ID as assigned by the provider upon creation of the property.

---

channel_hotel_id string (Required)

The unique id for the hotel on the specific channel.

---

Status string (Required)

The status to set for the property.

Should be "Closed", indicating the property should be closed.

---

reason_type string (Required)

The type of closure reason.

Valid values: "Season", "Renovation", "Property_Not_Available", "Fully_Booked", "Issues_Guests", "Issues_Booking", "Strategy", "Other".

---

reason_description string (Required)

A detailed description of why the property is being closed.

Must be a non-empty string describing the reason for closure.

---

Sample Request

{
    "hotel_id": "new1",
    "channel_hotel_id": "12926584",
    "status": "Closed",
    "reason_type": "Renovation",
    "reason_description": "The property is under renovation."
}

---

Response

Sample Success Response

{
    "Status": "Success",
    "Data": "",
    "Message": "Property Status fetched successfully"
}

Success Response Body Elements

Status string

Indicates the overall status of the request. In this case, "Success" means the operation was completed successfully.

---

Data object

Contains the main content of the response, specifically relevant information fetched by the API.

---

Message string

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

Errors

Sample Error Response 1 - Validation Error Response

{
    "Status": "Fail",
    "Errors": [
        {
            "Code": "400",
            "ShortText": "hotel_id: Invalid HotelCode ('')"
        },
        {
            "Code": "572",
            "ShortText": "channel_hotel_id - is invalid or not found!"
        },
        {
            "Code": "731",
            "ShortText": "property_status - is not valid or not found!"
        }
    ],
    "Message": ""
}

Sample Error Response 2 - Booking.com Error Response

{
    "Status": "Fail",
    "Errors": [],
    "Message": "NotProcessed - 733 : Cannot change status of a test hotel"
}

---

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.

---

Notes on Closing a Property

When a property is closed, it is important to specify the reason for the closure. The following reasons are supported:

Season: The property is closed during certain months of the year (e.g., winter).

Renovation: The property is under renovation.

Property_Not_Available: The property is closing indefinitely due to public crisis/government regulations.

Fully_Booked: The property is sold out through Booking.com, other websites, or direct bookings.

Issues_Guests: Issues caused by guests. Select this option for any of the following reasons:

• The property can't review guests.

• Guests caused property damages.

• Guests from Booking.com cancel too often.

• Guests don't pay.

Issues_Booking: Select this option for any of the following reasons:

• The property lacks support from Booking.com.

• The property feels that the commission is too high.

• The property faces issues with payments.

• The property faces issues with Extranet or other tools.

• The property prefers direct selling.

Strategy: · Select this option for any of the following reasons:

• The property is not sure about the price in the long term.

• The property wants to avoid cancellations.

• The property is planning to switch to a new property management company.

• The property's staff are on holiday.

Other: Any other reason that doesn't fall into the predefined categories.