Link/Retrieve Contract

Contract Retrieval api allows users to fetch the existing contact details.

---

Endpoint

POST

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

Attributes

hotel_id string (Required)

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

---

legal_entity_id string (Required)

The identity of the legal entity.

---

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 be in valid email format.

---

Sample Request

{
    "hotel_id": "AWSTEST",
    "legal_entity_id": "425500",
    "legal_contact_email": "[e-mail]"
}

---

Response

Sample Success Response

{
    "Status": "Success",
    "Message": "Successfully fetch property legal details",
    "Ruid": "e527c45a-f23a-4ee4-beb2-7d21f7699b1b",
    "Data": {
        "legal_entity_id": 248253,
        "city": "Amsterdam",
        "company_name": "Giovanni hotels",
        "contract_countries": [
            "France",
            "Netherlands"
        ],
        "total_number_of_properties": 2,
        "legal_contact_phone_number": "[phone]",
        "legal_contact_name": "Don Giovanni",
        "country": "Netherlands",
        "legal_contact_email": "[e-mail]",
        "contract_signed": 1
    }
}

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

The status of the response.

---

Message string

The message in the response.

---

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.

---

city string

The city of the Accommodation Partner.

---

company_name string

The commercial name of the Accommodation Partner company.

---

contract_countries string

The countries in which the Accommodation Partner has properties.

You can only see this array when the contract is signed.

---

total_number_of_properties string

The amount of properties connected to the Accommodation Partner.

---

legal_contact_phone_number string

The Accommodation Partner's legal contact phone number.

Follows the ITU E.164 standard.

---

legal_contact_name string

The Accommodation Partner's legal contact name.

---

country string

The country of the Accommodation Partner.

---

legal_contact_email string

The Accommodation Partner's legal contact email.

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

---

contract_signed boolean

Indicates whether the contract is signed.