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
-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 "Open", indicating that the property should be made available for booking.


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.

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.

Last updated

Was this helpful?