Skip to content
/Connection status

Connection status

Check the connection status of a property.

Operations

Check whether a property is connected to the provider

Request

Check the connection status between you and a property. The status field returns one of the following values:

  • connected: The property has an active connection with you. The response includes connected_at.
  • pending: The property has a pending connection request. The response includes requested_at.
  • not found: The property has neither an active connection nor a pending request with you.
Security
BearerAuth
Path
propertyIdinteger, (int64)required

The Booking.com property ID.

curl -i -X GET \
  'https://developers.booking.com/_mock/connectivity/docs/openapispecs/connections-api/connections-api-specification/properties/{propertyId}/status' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successful operation

Headers
X-RUIDstring, (uuid)

Unique request ID. Include this value when contacting support.

Bodyapplication/json
metaobject(ResponseMeta)
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
dataobject(ConnectionStatus)
Response

Property is connected

{
  "meta": {
    "ruid": "fee464e7-1b41-4834-b665-b2aeba62ba7d"
  },
  "warnings": [],
  "errors": [],
  "data": {
    "property_id": 11223344,
    "status": "connected",
    "connected_at": "2022-01-01T01:23:45Z"
  }
}