# Contacts objects

Property contact details are always contained in a `ContactInfos` element with one or more `ContactInfo` children. This page describes the elements and attributes in the `ContactInfos` descendants tree.

## Related calls

* [OTA_HotelDescriptiveContentNotif](/connectivity/docs/ota-hoteldescriptivecontentnotif) – Set a property's contact details.
* [OTA_HotelDescriptiveInfo](/connectivity/docs/ota-hoteldescriptiveinfo) – Retrieve a property's contact details.


## Sample XML

The sample below is an excerpt and not a valid XML document.

```xml
<ContactInfos>
  <ContactInfo ContactProfileType="PhysicalLocation">
    <Addresses>
      <Address>
        <AddressLine>Herengracht 567</AddressLine>
        <CityName>Amsterdam</CityName>
        <PostalCode>1017 CE</PostalCode>
        <CountryName>NL</CountryName>
      </Address>
    </Addresses>
  </ContactInfo>
  <ContactInfo ContactProfileType="availability" Index="1">
    <Names>
      <Name Language="en" Gender="male">
        <GivenName>Sam</GivenName>
        <Surname>Xu</Surname>
      </Name>
    </Names>
    <Emails>
      <Email>noreply@booking.com</Email>
    </Emails>
    <Phones>
      <Phone PhoneNumber="+31666666666" PhoneTechType="1" />
    </Phones>
  </ContactInfo>
  <ContactInfo ContactProfileType="general" Index="2">
    <Names>
      <Name Language="en" Gender="male">
        <GivenName>Sam</GivenName>
        <Surname>Xu</Surname>
      </Name>
    </Names>
    <Emails>
      <Email>noreply@booking.com</Email>
    </Emails>
    <Phones>
      <Phone PhoneNumber="+31666666666" PhoneTechType="1" />
    </Phones>
  </ContactInfo>
  <ContactInfo ContactProfileType="contract" Index="3">
    <Names>
      <Name Language="en" Gender="male">
        <GivenName>Sam</GivenName>
        <Surname>Xu</Surname>
      </Name>
    </Names>
    <Emails>
      <Email>noreply@booking.com</Email>
    </Emails>
    <Phones>
      <Phone PhoneNumber="+31666666666" PhoneTechType="1" />
    </Phones>
  </ContactInfo>
  <ContactInfo ContactProfileType="reservations" Index="4">
    <Names>
      <Name Language="en" Gender="male">
        <GivenName>Sam</GivenName>
        <Surname>Xu</Surname>
      </Name>
    </Names>
    <Emails>
      <Email>noreply@booking.com</Email>
    </Emails>
    <Phones>
      <Phone PhoneNumber="+31666666666" PhoneTechType="1" />
    </Phones>
  </ContactInfo>
  <ContactInfo ContactProfileType="invoices" Index="5">
    <Names>
      <Name Language="en" Gender="male">
        <GivenName>Sam</GivenName>
        <Surname>Xu</Surname>
      </Name>
    </Names>
    <Addresses>
      <Address>
        <AddressLine>Herengracht 594</AddressLine>
        <CityName>Amsterdam</CityName>
        <CountryName>NL</CountryName>
        <PostalCode>1017 CE</PostalCode>
      </Address>
    </Addresses>
    <Emails>
      <Email>noreply@booking.com</Email>
    </Emails>
    <Phones>
      <Phone PhoneNumber="+31666666666" PhoneTechType="1" />
    </Phones>
  </ContactInfo>
  <ContactInfo ContactProfileType="site_content" Index="6">
    <Names>
      <Name Language="en" Gender="male">
        <GivenName>Sam</GivenName>
        <Surname>Xu</Surname>
      </Name>
    </Names>
    <Emails>
      <Email>noreply@booking.com</Email>
    </Emails>
    <Phones>
      <Phone PhoneNumber="+31666666666" PhoneTechType="1" />
    </Phones>
  </ContactInfo>
  <ContactInfo ContactProfileType="parity" Index="7">
    <Names>
      <Name Language="en" Gender="male">
        <GivenName>Sam</GivenName>
        <Surname>Xu</Surname>
      </Name>
    </Names>
    <Emails>
      <Email>noreply@booking.com</Email>
    </Emails>
    <Phones>
      <Phone PhoneNumber="+31666666666" PhoneTechType="1" />
    </Phones>
  </ContactInfo>
  <ContactInfo ContactProfileType="requests" Index="8">
    <Names>
      <Name Language="en" Gender="male">
        <GivenName>Sam</GivenName>
        <Surname>Xu</Surname>
      </Name>
    </Names>
    <Emails>
      <Email>noreply@booking.com</Email>
    </Emails>
    <Phones>
      <Phone PhoneNumber="+31666666666" PhoneTechType="1" />
    </Phones>
  </ContactInfo>
  <ContactInfo ContactProfileType="central_reservations" Index="9">
    <Names>
      <Name Language="en" Gender="male">
        <GivenName>Sam</GivenName>
        <Surname>Xu</Surname>
      </Name>
    </Names>
    <Emails>
      <Email>noreply@booking.com</Email>
    </Emails>
    <Phones>
      <Phone PhoneNumber="+31666666666" PhoneTechType="1" />
    </Phones>
  </ContactInfo>
</ContactInfos>
```

## ContactInfo

Contains names, addresses, and other types of contact details. Child of `ContactInfos`.

| Field | Description | Type | Required | Notes |
|  --- | --- | --- | --- | --- |
| `ContactInfo[@ContactProfileType]` | Indicates the type of contact. | enum | Required | Accepts: `general`, `contract`, `reservations`, `invoices`, `availability`, `site_content`, `parity`, `requests`, `central_reservations`, `PhysicalLocation`. See [@ContactProfileType](/connectivity/docs/contacts#@contactprofiletype) for details. |
| `Addresses` | - | array of [Address](/connectivity/docs/contacts#address) | Optional | - |
| `Emails` | - | array of [Email](/connectivity/docs/contacts#email) | Optional | - |
| `Names` | - | array of [Name](/connectivity/docs/contacts#name) | Optional | Max. occurrences of `Name` per `ContactInfo` element: 1 |
| `Phones` | - | array of [Phone](/connectivity/docs/contacts#phone) | Optional | - |


### @ContactProfileType

The [ContactInfo](/connectivity/docs/contacts#contactinfo) attribute `@ContactProfileType` accepts the following values. Each value corresponds with a similarly named heading on the **Contacts** page in our [extranet](http://admin.booking.com).

| Value | Description | Required |
|  --- | --- | --- |
| `general` | Primary point of contact for the property. | Required |
| `contract` | Contact for contract matters. | Optional |
| `reservations` | Contact for reservations. | Optional |
| `invoices` | Contact for accounts payable. | Required |
| `availability` | Contact for questions about availability. | Optional |
| `site_content` | Contact for photos, descriptions, and other website content. | Optional |
| `parity` | Contact for pricing and rate matters. | Optional |
| `requests` | Contact for special requests. | Optional |
| `central_reservations` | Contact for central reservations. Applies to properties that manage reservations from another location. | Optional |
| `PhysicalLocation` | Address details for the property's physical location. | Required |


## Address

Contains address details. Child of `Addresses` (see [ContactInfo](/connectivity/docs/contacts#contactinfo)).

| Field | Description | Type | Required | Notes |
|  --- | --- | --- | --- | --- |
| `Address[@Language]` | The language in which the address details are provided. | enum | Optional | Accepts the values listed under [BCL](/connectivity/docs/codes-bcl). Default: `en` |
| `AddressLine` | The full street name and number. | string | Required | Should not contain abbreviations (such as "Rd." for "Road"). |
| `HotelName` | The name of the property. | string | Optional | Required when `Address[@Language]` is not `en`. Default: empty |
| `CityName` | The name of the city, town, or village. | string | Required | - |
| `PostalCode` | The postal or zip code. | string | Required | - |
| `StateProv` | - | object | Optional | - |
| `StateProv[@StateCode]` | Specifies the code for the state or province. | string | Optional | Follow the ISO 3166-2 standard to specify the state, province, or other subdivision. |
| `CountryName` | The two-letter code for the country, as defined in [our list of country codes](/connectivity/docs/b_xml-countries). | countrycode | Required | For accepted values, see [countries (B.XML)](/connectivity/docs/b_xml-countries) |


## Name

Contains a contact person's name details. Child of `Names` (see [ContactInfo](/connectivity/docs/contacts#contactinfo)).

| Field | Description | Type | Required | Notes |
|  --- | --- | --- | --- | --- |
| `Name[@Language]` | The contact's spoken language. | enum | Required | Accepts the values listed under [BCL](/connectivity/docs/codes-bcl). |
| `Name[@Gender]` | The contact's gender. | enum | Optional | Accepts these values: `male`, `female`. Default: empty.  **NOTE:** To set the contact's gender as empty, omit the entire attribute (rather than setting its value as `""`). |
| `GivenName` | The contact's given (first) name. | string | Optional | Required if `Surname` is not provided. |
| `Surname` | The contact's last name or family name. | string | Optional | Required if `GivenName` is not provided. |
| `JobTitle` | The contact's job title. | enum | Optional | Accepts the values listed under [BCJT](/connectivity/docs/codes-bcjt). |


## Email

Contains an email address. Child of `Emails` (see [ContactInfo](/connectivity/docs/contacts#contactinfo)). This element has no child elements or attributes—see [Sample XML](#sample-xml) for an example.

## Phone

Contains phone line details. Child of `Phones` (see [ContactInfo](/connectivity/docs/contacts#contactinfo)).

| Field | Description | Type | Required | Notes |
|  --- | --- | --- | --- | --- |
| `Phone[@PhoneNumber]` | The international phone number that must be dialled to reach the phone. | string | Required | Must begin with `+`, followed by all digits required to dial internationally. No whitespace, hyphens, or other characters allowed. |
| `Phone[@PhoneTechType]` | The type of phone line or device, expressed as a [PTT code](/connectivity/docs/codes-ptt). | enum | Optional | See [PTT codes](/connectivity/docs/codes-ptt) for accepted values. |
| `Phone[@Extension]` | The extension number that must be dialled in addition to the main phone number. | integer | Optional | Only allowed when `@PhoneTechType` is `1`. |