Property Status Open
This endpoint opens a property and makes it available on Booking.com. The status can be set to "Open" to indicate that the property is now available for bookings.
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
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.
Sample Request
{
"hotel_id": "new1", // required
"channel_hotel_id": "12926584", // required
"status": "Open", // required
}
Response
Sample Success Response
{
"Status": "Success",
"Data": "",
"Message": "Property Status open 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.
ShortText
string
A short description of the error.
Message
string
A message providing more information about the error.
Last updated
Was this helpful?