Help Center
Login Sign up
  1. Home
  2. API reference
  3. API documentation (JSON/XML)
  4. Tasks
  5. Contact tasks

Contact history list

API reference (XML/JSON) · Updated 2023-09-13

Function

The ContactHistoryList task inquires contacts that were created in a specified time period. This task is not available in JSON.

You can find more information about list queries here. 

Description

Task code: 0325
Uses contact object

Keywords

The following keywords are returned by default:

  • address
  • alias
  • city
  • country
  • fax
  • fname
  • lname
  • organization
  • title
  • type
  • pcode
  • state
  • phone
  • verification

The data of the following keywords can be inquired with the keyword <key>:

  • email
  • domainsafe
  • comment
<request>
	<auth>
		<user>customer</user>
		<context>4</context>
		<password>password</password>
	</auth>
	<task>
		<code>0325</code>
		<view>
			<offset>0</offset>
			<limit>10</limit>
			<children>0</children>
			<from>2019-01-01 00:00:00</from>
			<to>2050-12-31 00:00:00</to>
		</view>
		<where>
			<key>lname</key>
			<operator>like</operator>
			<value>*</value>
		</where>
	</task>
</request>
<response>
	<result>
		<data>
			<summary>64</summary>
			<handle>
				<alias>customer</alias>
				<type>PERSON</type>
				<fname>John</fname>
				<lname>Doe</lname>
				<organization>example organization</organization>
				<title/>
				<address>example street</address>
				<pcode>12345</pcode>
				<city>example city</city>
				<country>DE</country>
				<state>DE</state>
				<phone>+49-123-123</phone>
				<fax>+49-123-123</fax>
				<log_id>2296990</log_id>
				<verification>FAILED</verification>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<id>23339618</id>
				<created>2021-10-01 10:02:25</created>
				<updated>2021-10-01 10:02:25</updated>
			</handle>
			<handle>
				<alias>Anne Doe</alias>
				<type>PERSON</type>
				<fname>Anne</fname>
				<lname>Doe</lname>
				<organization>example organization</organization>
				<title/>
				<address>example street</address>
				<pcode>12345</pcode>
				<city>example city</city>
				<country>DE</country>
				<state>DE</state>
				<phone>+49-123-123</phone>
				<fax>+49-123-123</fax>
				<log_id>2296992</log_id>
				<verification>SUCCESS</verification>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<id>23339620</id>
				<created>2021-10-01 10:15:01</created>
				<updated>2021-10-01 10:15:01</updated>
			</handle>
		</data>
		<status>
			<code>S0325</code>
			<text>Contact histories were inquired successfully.</text>
			<type>success</type>
		</status>
	</result>
	<stid>20211125-app2-dev-118421</stid>
</response>