Skip to content
/Requests

Requests

Retrieve, approve, and reject pending connection requests from properties.

Operations

Approve a pending connection request

Request

Accept a pending connection request from a property. On success, the request becomes an active connection and the endpoint returns the connection details. To accept requests from multiple properties, call this endpoint once for each property ID.

The request body is optional. Use it to:

  • Set the pricing_model. The pricing model only applies when the request includes the AVAILABILITY connection type. You must be certified to use a pricing model other than Standard.
  • Confirm the scope of the connection with connection_types. If you specify connection types, they must exactly match the connection types the property requested. Otherwise, the endpoint returns an error.
Security
BearerAuth
Path
propertyIdinteger, (int64)required

The Booking.com property ID.

Bodyapplication/json

Optional. Specify the pricing model and confirm the connection types you intend to approve.

pricing_modelstring

Pricing model for the connection. Only applies when the request includes the AVAILABILITY connection type. You must be certified to use a pricing model other than Standard. Values are case-insensitive.

Enum:"Standard""OBP""LOS"
connection_typesArray of strings
Items Enum:"RESERVATIONS""AVAILABILITY""REVIEWS""CONTENT""PHOTOS""MESSAGING""PROMOTIONS""PERFORMANCE""FACILITIES""PROPERTY_SETTINGS"

Approve a request using the Standard pricing model and confirm the requested connection types.

curl -i -X POST \
  'https://developers.booking.com/_mock/connectivity/docs/openapispecs/connections-api/connections-api-specification/properties/{propertyId}/request:approve' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "pricing_model": "Standard",
    "connection_types": [
      "AVAILABILITY",
      "PHOTOS",
      "RESERVATIONS",
      "REVIEWS",
      "REPORTING",
      "CONTENT"
    ]
  }'

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

The connection request was approved and is now an active connection.

{
  "meta": {
    "ruid": "4589148f-c8ca-44ad-8b14-e3a909d602a3"
  },
  "warnings": [],
  "errors": [],
  "data": {
    "legal_entity": { … },
    "connection_types": { … },
    "connected_at": "2023-08-03T14:06:22Z",
    "last_connected_at": "2023-08-03T14:06:22Z",
    "property": { … },
    "pricing": { … }
  }
}