Create Contract

This endpoint is designed for new accommodation partners joining Booking.com. By using this API, partners can establish a contractual agreement, which will generate a legal entity number. This number will be automatically linked to the specified property, facilitating a seamless onboarding process for new listings.

---

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/contract/create

Attributes

hotel_id string (Required)

The unique property ID as assigned by the provider upon creation of the property.

---

legal_name string (Required)

The legal name of the Accommodation Partner company.

---

legal_contact_name string (Required)

The Accommodation Partner's legal contact name.

---

legal_contact_email string (Required)

The Accommodation Partner's legal contact email.

The system sees this email as the unique identifier for the Accommodation Partner.

It should follow standard email format.

---

legal_contact_phone_number string (Required)

The Accommodation Partner's legal contact phone number.

It should include the country code (for example, +1, +44).

Follows ITU E.164.

---

Company_name string (Required)

The commercial name of the Accommodation Partner company.

---

city string (Required)

The city of the Accommodation Partner company.

---

country string (Required)

The country of the Accommodation Partner company.

To retrieve a list of the available country codes, see retrieving country codes.

---

street string (Required)

Name of the street.

---

total_number_of_properties string (Required)

The amount of properties connected to the Accommodation Partner.

---

zipcode string (Required)

The zipcode of the Accommodation Partner company.

---

website string (Required)

The website of the Accommodation Partner company.

Should start with http:// or https://.

---

contract_countries string (Required)

The countries in which the Accommodation Partner has properties.

You should include all the countries in which the Accommodation Partner has properties in. To retrieve a list of the available country codes, see retrieving country codes.

---

language string (Required)

The preferred language in which the Accommodation Partner wants to communicate.

For the language codes, see Booking.com Language Code.

---

Sample Request

{
    "hotel_id": "AWSTEST",
    "legal_name": "Giovanni hotels BV",
    "legal_contact_name": "Don Giovanni",
    "legal_contact_email": "[e-mail]",
    "legal_contact_phone_number": "[phone]",
    "company_name": "Giovanni hotels",
    "city": "Amsterdam",
    "country": "nl",
    "street": "Streetstreet",
    "total_number_of_properties": "2",
    "zipcode": "1000AB",
    "website": "https://www.besthotel.com",
    "contract_countries": [
        "fr",
        "nl"
    ],
    "language": "en"
}

---

Response

Sample Success Response

{
    "Status": "Success",
    "Message": "Successfully generated property legal entity id",
    "Ruid": "e527c45a-f23a-4ee4-beb2-7d21f7699b1b",
    "Data": {
        "legal_entity_id": 425500
    }
}

Error

Sample Error Response

{
  "Status": "Fail",
  "Errors": [],
  "Message": "Trying to create a duplicate account!, Trying to create a duplicate countries!",
  "Ruid": "e527c45a-f23a-4ee4-beb2-7d21f7699b1b",
  "data": {}
}

Response Body Elements

Status string

This field indicates the success of the request.

• Success - It confirms that the property legal details were successfully fetched and the data was fetched without any errors.

• Fail - It confirms that the property legal details were not fetched and the operation got failed.

---

Message string

This field provides a user-friendly message regarding the operation performed.

---

Ruid string

Specifies the unique request ID.

You can share this ID with Booking.com customer support when you run into an issue. This can help in understanding what went wrong.

---

data object

The response data.

---

legal_entity_id integer

The unique legal entity ID.