Last updated

Step 15 - Check property status

Use the Property API to check the status of the property. If all checks pass, then your property can be made Open / bookable.

While the API performs similar validation on all properties, only production-ready properties can be set to an "Open" or "Bookable" state. Test properties cannot be set to this state.

Prerequisites

You must have completed all the previous steps to successfully pass all checks.

Checking the status

POST
https://supply-xml.booking.com/property-api/properties/{{propertyID}}/status

Path parameters

The following table describes the elements you must specify in the path:

ElementDescriptionTypeRequired/
Optional
Notes
propertyIDSpecifies the unique ID of the property.integerrequired

Request body parameters

The following table describes the elements you can add in the request body:

ElementDescription
operationSpecifies the operation to perform on the property. Supports the following values:
- Check
- Open
- Close

Request body example

The following is a request body example:

{
    "operation" : "Check"
 }
 

Response body example

The following is a successful response body example:

Because the tutorial uses a sample licence number in Step 8 when adding licence information, the API might report a licence validation error for the room. You can either ignore this error or repeat sending the licence information for the room before rerunning this status check.

{
    "data": {
        "status": "Checks have passed, property may now be opened."
    },
    "warnings": [],
    "errors": [],
    "meta": {
        "ruid": "XXXXXXXXXXXXXXXXXXXXXXXXX"
    }
}