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": { … }
  }
}