Retrieve Contact

This endpoint retrieves detailed information about a specific contact.

---

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/property/contact/retrieve

Header

-app-id: YOUR_APP_ID
Authorization: YOUR_API_KEY
Content-Type:application/json

Header	Type	Required	Description
app-id	string	Yes	Your application ID. Required for authentication.
Authorization	string	Yes	Your API key for authorization.
Content-Type	string	Yes	Must be set to application/json.

---

Attributes

---

hotel_id alphanumeric (Required)

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

---

channel_hotel_id string (Required)

The unique id for the legal entity associated with the hotel. the unique ID of the property on channel to retrieve its details.

---

Sample Request

{
   "hotel_id": "NT7",
   "channel_hotel_id": "12837615"
}

---

Response

Sample Success Response

{
   "Status": "Success",
   "Data": {
       "contacts": [
           {
               "contact_profiles": [
                   {
                       "type": "invoices"
                   }
               ],
               "address": {
                   "city_name": "Amsterdam",
                   "country_code": "NL",
                   "postal_code": "1011 DL",
                   "address_line": "New Straat 123",
                   "language_code": "en-gb"
               },
               "contact_person": {
                   "gender": "female",
                   "name": "Waddington Bloem",
                   "job_title": "Administration Employee",
                   "language_code": "en-gb"
               },
               "phones": [
                   {
                       "phone_number": "[phone]",
                       "phone_tech_type": 1,
                       "extension": "1"
                   }
               ],
               "email": "[e-mail]"
           },
           {
               "contact_profiles": [
                   {
                       "type": "general"
                   }
               ],
               "address": {
                   "city_name": "Amsterdam",
                   "country_code": "NL",
                   "postal_code": "1011 DL",
                   "address_line": "New Straat 456",
                   "language_code": "en-gb"
               },
               "contact_person": {
                   "gender": "male",
                   "name": "Bensen Clay",
                   "job_title": "Administration Employee",
                   "language_code": "en-gb"
               },
               "phones": [
                   {
                       "phone_number": "[phone]",
                       "phone_tech_type": 1,
                       "extension": "1"
                   }
               ],
               "email": "[e-mail]"
           }
       ]
   },
   "Message": "Property Contact-Details Fetched Successfully"
}

Error

Sample Error Response 1

{
   "Errors": [
       {
           "Code": "400",
           "ShortText": "HotelCode: Invalid HotelCode ('NT711')"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 2

{
   "Errors": [
       {
           "Code": "573",
           "ShortText": "channel-mapping not found for this property!"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 3

{
   "Status": "Fail",
   "Errors": [],
   "Message": "Access denied"
}

Response Body Elements

Status string

The status of the response.

---

Data object

The response data, the root element.

---

contacts array

An array of contact objects containing contact details.

---

contact_profiles array

A list of profiles associated with the contact (for example, invoices, general).

---

address object

Contains the address details of the contact including country, city and postal code details.

city_name string

The city name where the contact is located.

country_codeenumerated string

The ISO country code of the contact's location.

postal_code string

The postal code of the contact's location.

address_line string

The street address of the contact.

language_code enumerated string

The language code for the address.

---

contact_person object

Details about the contact person.

gender enumerated string

Gender of the contact person.

name string

Full name of the contact person.

job_title enumerated string

Job title of the contact person.

language_code string

Language code for the contact person (for example, 'en-gb').

---

phones array

List of phone numbers associated with the contact.

phone_number string

The actual phone number (all international phone numbers).

phone_tech_type enumerated string

Technology type of the phone (for example, '1' for landline).

extension string

Extension number for the phone, if applicable.

---

email string

Email address of the contact.

---

Error array

Array that contains details about any errors that occurred during the API call. Each object in the Errors array contains the following properties:

Code string

Specific error code that helps identify the type of error.

ShortText string

Brief description of the error.