This endpoint retrieves detailed information about a specific contact.
POST
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.
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.
https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/property/contact/retrieveapp-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.
-app-id: YOUR_APP_ID
Authorization: YOUR_API_KEY
Content-Type:application/json{
"hotel_id": "NT7",
"channel_hotel_id": "12837615"
}{
"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": "+31243611111",
"phone_tech_type": 1,
"extension": "1"
}
],
"email": "test@booking.com"
},
{
"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": "+31243611111",
"phone_tech_type": 1,
"extension": "1"
}
],
"email": "tests@booking.com"
}
]
},
"Message": "Property Contact-Details Fetched Successfully"
}{
"Errors": [
{
"Code": "400",
"ShortText": "HotelCode: Invalid HotelCode ('NT711')"
}
],
"Status": "Fail"
}{
"Errors": [
{
"Code": "573",
"ShortText": "channel-mapping not found for this property!"
}
],
"Status": "Fail"
}{
"Status": "Fail",
"Errors": [],
"Message": "Access denied"
}