{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Contacts objects","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"contacts-objects","__idx":0},"children":["Contacts objects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Property contact details are always contained in a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ContactInfos"]}," element with one or more ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ContactInfo"]}," children. This page describes the elements and attributes in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ContactInfos"]}," descendants tree."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-calls","__idx":1},"children":["Related calls"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/ota-hoteldescriptivecontentnotif"},"children":["OTA_HotelDescriptiveContentNotif"]}," – Set a property's contact details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/ota-hoteldescriptiveinfo"},"children":["OTA_HotelDescriptiveInfo"]}," – Retrieve a property's contact details."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sample-xml","__idx":2},"children":["Sample XML"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The sample below is an excerpt and not a valid XML document."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"xml","header":{"controls":{"copy":{}}},"source":"<ContactInfos>\n  <ContactInfo ContactProfileType=\"PhysicalLocation\">\n    <Addresses>\n      <Address>\n        <AddressLine>Herengracht 567</AddressLine>\n        <CityName>Amsterdam</CityName>\n        <PostalCode>1017 CE</PostalCode>\n        <CountryName>NL</CountryName>\n      </Address>\n    </Addresses>\n  </ContactInfo>\n  <ContactInfo ContactProfileType=\"availability\" Index=\"1\">\n    <Names>\n      <Name Language=\"en\" Gender=\"male\">\n        <GivenName>Sam</GivenName>\n        <Surname>Xu</Surname>\n      </Name>\n    </Names>\n    <Emails>\n      <Email>noreply@booking.com</Email>\n    </Emails>\n    <Phones>\n      <Phone PhoneNumber=\"+31666666666\" PhoneTechType=\"1\" />\n    </Phones>\n  </ContactInfo>\n  <ContactInfo ContactProfileType=\"general\" Index=\"2\">\n    <Names>\n      <Name Language=\"en\" Gender=\"male\">\n        <GivenName>Sam</GivenName>\n        <Surname>Xu</Surname>\n      </Name>\n    </Names>\n    <Emails>\n      <Email>noreply@booking.com</Email>\n    </Emails>\n    <Phones>\n      <Phone PhoneNumber=\"+31666666666\" PhoneTechType=\"1\" />\n    </Phones>\n  </ContactInfo>\n  <ContactInfo ContactProfileType=\"contract\" Index=\"3\">\n    <Names>\n      <Name Language=\"en\" Gender=\"male\">\n        <GivenName>Sam</GivenName>\n        <Surname>Xu</Surname>\n      </Name>\n    </Names>\n    <Emails>\n      <Email>noreply@booking.com</Email>\n    </Emails>\n    <Phones>\n      <Phone PhoneNumber=\"+31666666666\" PhoneTechType=\"1\" />\n    </Phones>\n  </ContactInfo>\n  <ContactInfo ContactProfileType=\"reservations\" Index=\"4\">\n    <Names>\n      <Name Language=\"en\" Gender=\"male\">\n        <GivenName>Sam</GivenName>\n        <Surname>Xu</Surname>\n      </Name>\n    </Names>\n    <Emails>\n      <Email>noreply@booking.com</Email>\n    </Emails>\n    <Phones>\n      <Phone PhoneNumber=\"+31666666666\" PhoneTechType=\"1\" />\n    </Phones>\n  </ContactInfo>\n  <ContactInfo ContactProfileType=\"invoices\" Index=\"5\">\n    <Names>\n      <Name Language=\"en\" Gender=\"male\">\n        <GivenName>Sam</GivenName>\n        <Surname>Xu</Surname>\n      </Name>\n    </Names>\n    <Addresses>\n      <Address>\n        <AddressLine>Herengracht 594</AddressLine>\n        <CityName>Amsterdam</CityName>\n        <CountryName>NL</CountryName>\n        <PostalCode>1017 CE</PostalCode>\n      </Address>\n    </Addresses>\n    <Emails>\n      <Email>noreply@booking.com</Email>\n    </Emails>\n    <Phones>\n      <Phone PhoneNumber=\"+31666666666\" PhoneTechType=\"1\" />\n    </Phones>\n  </ContactInfo>\n  <ContactInfo ContactProfileType=\"site_content\" Index=\"6\">\n    <Names>\n      <Name Language=\"en\" Gender=\"male\">\n        <GivenName>Sam</GivenName>\n        <Surname>Xu</Surname>\n      </Name>\n    </Names>\n    <Emails>\n      <Email>noreply@booking.com</Email>\n    </Emails>\n    <Phones>\n      <Phone PhoneNumber=\"+31666666666\" PhoneTechType=\"1\" />\n    </Phones>\n  </ContactInfo>\n  <ContactInfo ContactProfileType=\"parity\" Index=\"7\">\n    <Names>\n      <Name Language=\"en\" Gender=\"male\">\n        <GivenName>Sam</GivenName>\n        <Surname>Xu</Surname>\n      </Name>\n    </Names>\n    <Emails>\n      <Email>noreply@booking.com</Email>\n    </Emails>\n    <Phones>\n      <Phone PhoneNumber=\"+31666666666\" PhoneTechType=\"1\" />\n    </Phones>\n  </ContactInfo>\n  <ContactInfo ContactProfileType=\"requests\" Index=\"8\">\n    <Names>\n      <Name Language=\"en\" Gender=\"male\">\n        <GivenName>Sam</GivenName>\n        <Surname>Xu</Surname>\n      </Name>\n    </Names>\n    <Emails>\n      <Email>noreply@booking.com</Email>\n    </Emails>\n    <Phones>\n      <Phone PhoneNumber=\"+31666666666\" PhoneTechType=\"1\" />\n    </Phones>\n  </ContactInfo>\n  <ContactInfo ContactProfileType=\"central_reservations\" Index=\"9\">\n    <Names>\n      <Name Language=\"en\" Gender=\"male\">\n        <GivenName>Sam</GivenName>\n        <Surname>Xu</Surname>\n      </Name>\n    </Names>\n    <Emails>\n      <Email>noreply@booking.com</Email>\n    </Emails>\n    <Phones>\n      <Phone PhoneNumber=\"+31666666666\" PhoneTechType=\"1\" />\n    </Phones>\n  </ContactInfo>\n</ContactInfos>\n","lang":"xml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"contactinfo","__idx":3},"children":["ContactInfo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contains names, addresses, and other types of contact details. Child of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ContactInfos"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ContactInfo[@ContactProfileType]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates the type of contact."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enum"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accepts: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contract"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservations"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoices"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["availability"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["site_content"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parity"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requests"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["central_reservations"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PhysicalLocation"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts#@contactprofiletype"},"children":["@ContactProfileType"]}," for details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Addresses"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts#address"},"children":["Address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Emails"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts#email"},"children":["Email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Names"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts#name"},"children":["Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Max. occurrences of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Name"]}," per ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ContactInfo"]}," element: 1"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Phones"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts#phone"},"children":["Phone"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"contactprofiletype","__idx":4},"children":["@ContactProfileType"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts#contactinfo"},"children":["ContactInfo"]}," attribute ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@ContactProfileType"]}," accepts the following values. Each value corresponds with a similarly named heading on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contacts"]}," page in our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://admin.booking.com"},"children":["extranet"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Primary point of contact for the property."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contract"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for contract matters."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for reservations."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoices"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for accounts payable."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["availability"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for questions about availability."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["site_content"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for photos, descriptions, and other website content."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for pricing and rate matters."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requests"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for special requests."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["central_reservations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for central reservations. Applies to properties that manage reservations from another location."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PhysicalLocation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Address details for the property's physical location."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"address","__idx":5},"children":["Address"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contains address details. Child of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Addresses"]}," (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts#contactinfo"},"children":["ContactInfo"]},")."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Address[@Language]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The language in which the address details are provided."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enum"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accepts the values listed under ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-bcl"},"children":["BCL"]},". Default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AddressLine"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The full street name and number."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Should not contain abbreviations (such as \"Rd.\" for \"Road\")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HotelName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The name of the property."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Address[@Language]"]}," is not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en"]},". Default: empty"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CityName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The name of the city, town, or village."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PostalCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The postal or zip code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["StateProv"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["StateProv[@StateCode]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the code for the state or province."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Follow the ISO 3166-2 standard to specify the state, province, or other subdivision."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CountryName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The two-letter code for the country, as defined in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/b_xml-countries"},"children":["our list of country codes"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["countrycode"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For accepted values, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/b_xml-countries"},"children":["countries (B.XML)"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"name","__idx":6},"children":["Name"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contains a contact person's name details. Child of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Names"]}," (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts#contactinfo"},"children":["ContactInfo"]},")."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Name[@Language]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The contact's spoken language."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enum"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accepts the values listed under ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-bcl"},"children":["BCL"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Name[@Gender]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The contact's gender."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enum"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accepts these values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["male"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["female"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["non-binary"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["undisclosed"]},". Default: empty. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE:"]}," To set the contact's gender as empty, omit the entire attribute (rather than setting its value as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"\""]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GivenName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The contact's given (first) name."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Surname"]}," is not provided."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Surname"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The contact's last name or family name."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GivenName"]}," is not provided."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JobTitle"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The contact's job title."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enum"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accepts the values listed under ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-bcjt"},"children":["BCJT"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"email","__idx":7},"children":["Email"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contains an email address. Child of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Emails"]}," (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts#contactinfo"},"children":["ContactInfo"]},"). This element has no child elements or attributes—see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#sample-xml"},"children":["Sample XML"]}," for an example."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"phone","__idx":8},"children":["Phone"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contains phone line details. Child of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Phones"]}," (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts#contactinfo"},"children":["ContactInfo"]},")."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Phone[@PhoneNumber]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The international phone number that must be dialled to reach the phone."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must begin with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["+"]},", followed by all digits required to dial internationally. No whitespace, hyphens, or other characters allowed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Phone[@PhoneTechType]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The type of phone line or device, expressed as a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-ptt"},"children":["PTT code"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enum"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-ptt"},"children":["PTT codes"]}," for accepted values."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Phone[@Extension]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The extension number that must be dialled in addition to the main phone number."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only allowed when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@PhoneTechType"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"."]}]}]}]}]}]},"headings":[{"value":"Contacts objects","id":"contacts-objects","depth":1},{"value":"Related calls","id":"related-calls","depth":2},{"value":"Sample XML","id":"sample-xml","depth":2},{"value":"ContactInfo","id":"contactinfo","depth":2},{"value":"@ContactProfileType","id":"contactprofiletype","depth":3},{"value":"Address","id":"address","depth":2},{"value":"Name","id":"name","depth":2},{"value":"Email","id":"email","depth":2},{"value":"Phone","id":"phone","depth":2}],"frontmatter":{"title":"Contacts objects","description":"Reference for the ContactInfos, ContactInfo, Address, Name, Email, and Phone XML elements used to manage property contact details in the Booking.com Content API.","keywords":{"includes":["ContactInfos","ContactInfo","ContactProfileType","PhysicalLocation","PhoneNumber","GivenName","Surname","JobTitle"]},"excludeFromSearch":true,"seo":{"title":"Contacts objects"}},"lastModified":"2026-10-22T13:19:21.144Z","pagePropGetterError":{"message":"","name":""}},"slug":"/connectivity/docs/contacts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}