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.
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.
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.
Read the Contracting API documentation for more details about working with this API.
Flag to filter in/out test partner cards. Setting it to 1 will look for test partners only, 0 will look for non-test partners only.
curl -i -X POST \
https://developers.booking.com/_mock/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/partners/legal-details \
-H 'Authorization: string' \
-H 'Content-Type: application/json' \
-d '{
"legal_contact_email": "peter.park+test01@besthotelxyz.abc"
}'OK
Commercial name of the company. Use the partner name if a commercial name is not available.
A list of all the country names for which contract has been signed.
Indicates whether the partner contract is signed. Returns 1 if signed, 0 if unsigned.
Contact email of the partner. This is treated as the unique identifier for the partner.
Contact name of the person authorized to sign.
Contact phone number of the partner.
The legal entity ID of the new partner invited.
{ "errors": [], "meta": { "ruid": "UmFuZG9tSVYkc2RlIyh9YRll+GVIGb80fIDE6KNg2nbBKSUQRt7HhDjIguTKWN9Pg8gPklY1ZTR8dD1jnGM3rO5t+gxp8LWUtuQkhhMwEqI=" }, "warnings": [], "data": { "legal_contact_phone_number": "+1234567890", "city": "Amsterdam", "legal_entity_id": 14379109, "total_number_of_properties": 2, "legal_contact_name": "Swan Park", "contract_signed": 0, "country": "Netherlands", "company_name": "Parker hotels", "legal_contact_email": "peter.park+test01@besthotelxyz.abc", "contract_countries": [] } }
curl -i -X GET \
'https://developers.booking.com/_mock/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/partners/legal-details/legal-entity/{id}'OK
Commercial name of the company. Use the partner name if a commercial name is not available.
A list of all the country names for which contract has been signed.
Indicates whether the partner contract is signed. Returns 1 if signed, 0 if unsigned.
Contact email of the partner. This is treated as the unique identifier for the partner.
Contact name of the person authorized to sign.
Contact phone number of the partner.
The legal entity ID of the new partner invited.
{ "meta": { "ruid": "UmFuZG9tSVYkc2RlIyh9YXJtZEFqth9mfKWAQSzFM+NoL9XfH+8fk9tAnQIdYDtio5B/cZzBRDAIjKvHJ7U6HDa9DoKs6xKWe91kJYn9IYI=" }, "errors": [], "warnings": [], "data": { "legal_entity_id": 14379109, "legal_contact_name": "Swan Park", "company_name": "Parker hotels", "total_number_of_properties": 2, "country": "Netherlands", "legal_contact_email": "peter.park+test01@besthotelxyz.abc", "contract_signed": 0, "legal_contact_phone_number": "+1234567890", "city": "Amsterdam", "contract_countries": [] } }
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.