---
title: "Contact history list"
url: "https://help.internetx.com/en/api/core-contact-history-list/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Tasks > Contact tasks"
updated: "2023-09-13"
---

# Contact history list

## Function

The _ContactHistoryList t_ask 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](/en/api/core-list-inquire/). 

## Description

-   [**XML**](#87031 "XML")

Task code: 0325  
Uses [contact](/en/api/core-contact-object/) 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>
```