Contracting API (1.0.0)

Use the Contracting API to invite a new partner on Booking.com, check whether a partner has signed the contract, resend invitation mail and retrieve the legal entity of the partner.

Authentication

The Contracting API supports token-based authentication. Each request must have an Authorization header containing a JWT token. Manage your machine accounts in the Connectivity Portal. See also the Authentication page of the documentation.

Message formats

The Contracting API accepts and returns JSON.

Documentation

Read the Contracting API documentation for more details about working with this API.

Languages
Servers
Test static response
https://developers.booking.com/_mock/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/
Test using live endpoint
https://supply-xml.booking.com/contracts-api/

Manage contracts

Create, update or resend contract details.

Operations

Request access

Request access to existing partner.

Operations

Request access to existing partner

Request

Use this endpoint to request access to an existing partner of Booking.com

Headers
Authorizationstring
Bodyapplication/json
le_idinteger(int32)

Legal entity ID of the partner. This is treated as the unique identifier for the partner.

legal_contact_emailstring

Contract contact email id of the partner. This is treated as the unique identifier for the partner.

curl -i -X POST \
  https://developers.booking.com/_mock/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/partners/request_access \
  -H 'Authorization: string' \
  -H 'Content-Type: application/json' \
  -d '{
    "le_id": 14379109
  }'

Responses

OK

Bodyapplication/json
dataobjectrequired
data.​link_to_connectstringrequired

URL link for the partner to authorize the connectivity provider.

errorsArray of objects(DiagnosisList)
metaobjectrequired
meta.​ruidstringrequired

Response Unique Identifier. Refer to this when talking to Booking.com Connectivity Support.

Example: "UmFuZG9tSVYkc2Rl...="
warningsArray of objects(DiagnosisList)
Response
application/json
{ "data": { "link_to_connect": "https://admin.booking.com/hotel/hoteladmin/extranet_ng/manage/channel-manager/authorize_connectivity_provider.html?uuid=CFCE5640-Q21A-00Z0-892F-8FF19DC8E916" }, "errors": [], "warnings": [], "meta": { "ruid": "UmFuZG9tSVYkc2RlIyh9YfU1y5UhuOwySx8U7ODUMv1XFnS2gZqGrD7Qnnx7KwM3nrQ86Wa25ThCRDZD+9g/b3Alw/i7IPQV9GXD3lES74I=" } }

About Try it

Learn how to effectively use the Try it feature in the Contracting API documentation.

Use the Try it feature to send test request examples to the API endpoints directly from the developer portal and depending on the selected environment either see static, pre-built responses or dynamic responses from a test property.