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.
Commercial name of the company. Use the partner name if a commercial name is not available.
Indicates whether to create a test partner. Set to 1 for test partners, 0 for production partners.
Contact email of the partner. This is treated as the unique identifier for the partner.
Legal name of the company used for official registration. Use the partner name if a legal name is not available.
curl -i -X POST \
https://developers.booking.com/_mock/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/partners/invite \
-H 'Authorization: string' \
-H 'Content-Type: application/json' \
-d '{
"city": "Amsterdam",
"company_name": "Parker hotels",
"country": "nl",
"legal_contact_email": "peter.park+test01@besthotelxyz.abc",
"contract_countries": [
"fr",
"nl"
],
"legal_contact_name": "Swan Park",
"legal_contact_phone_number": "+1234567890",
"legal_name": "Park hotels BV",
"preferred_language": "NL",
"street": "Streetstreet",
"total_number_of_properties": 2,
"zipcode": "1000AB",
"website": "https://www.besthotelxyz.abc",
"is_test": "1"
}'{ "meta": { "ruid": "XNlckRhdGEkYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4eXoxMjM0NTY3ODkwQUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVoxMjM0NTY3ODkw=" }, "errors": [], "data": { "legal_entity_id": 22567 }, "warnings": [] }
List of country codes where partner has properties for which addendum should be signed.
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.
Legal entity 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/addendum \
-H 'Authorization: string' \
-H 'Content-Type: application/json' \
-d '{
"additional_countries": [
"be"
],
"le_id": 14379109
}'Response when adding countries to a partner with a signed contract. Addendum invitation is successfully sent to the partner.
{ "data": { "success": 1, "status": "Addendum invitation sent to Partner." }, "errors": [], "warnings": [], "meta": { "ruid": "UlPrZG9tSVYkc2RlIyh9YeobhK72bvPcGuKpIGBV43CLA0/ew3f32vvfbcDMZPMJ2upJzzPiWPpwqgrzqgrYuylZFVYodyywjTysIR2C7iIMdzNV3jh==" } }
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/resend-invite \
-H 'Content-Type: application/json' \
-d '{
"legal_contact_email": "peter.park+test01@besthotelxyz.abc"
}'{ "meta": { "ruid": "UmFuZG9tSVYkc2RlIyh9Ya+pg/21ggUOrSQsocNZo8+onmuF/0Np5bNl9bXkIHOzcL5xe4+2Q5m5Yz4XU6LD/TrgwjmmpchX1cKrgLwhK4o=" }, "data": { "status": "Invitation sent to Partner.", "success": 1 }, "warnings": [], "errors": [] }
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.