Skip to content
/Connections

Connections

Retrieve and deactivate active connections with properties.

Operations

Retrieve a single active connection

Request

Retrieve details about the active connection with a property.

Note: This endpoint only checks for active connections. If no active connection is found, the endpoint returns an empty data object. This happens both when the property is not connected to you at all and when it has a pending connection request.

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}/connection' \
  -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(ActiveConnection)
Response

Connection found

{
  "meta": {
    "ruid": "fee464e7-1b41-4834-b665-b2aeba62ba7d"
  },
  "warnings": [],
  "errors": [],
  "data": {
    "legal_entity": { … },
    "connection_types": { … },
    "connected_at": "2022-01-01T01:23:45Z",
    "last_connected_at": "2023-07-01T12:34:56Z",
    "property": { … },
    "pricing": { … }
  }
}