Home
/
API reference
/
API documentation (JSON/XML)
/
Tasks
/
Contact tasks

Contact update

API reference (XML/JSON) · Updated 2026-04-09

Function

The ContactUpdate task updates a contact.

Domain contact data that is not sent with the ContactUpdate request will be deleted. To avoid the deletion of data, you must always send all data to the system when updating contacts. In advance you can enquire the data with a ContactInfo request.

Example:
When you send a ContactUpdate request to the system without a fax number, the fax number is deleted from the system.

Data Validation

The address data is validated when the contact is updated and address data has changed. The validation results in values from A to E. If the validation result is D or E, the contact create fails with the error code . It is possible to ignore the validation result and create the contact anyway.
To do this, the key ignoreAddressQuality can be specified using the query parameter keys[]. If the quality is D or E, you can trigger another check with the parameter recheckAddressQuality.
If the quality is still D or E, the update will fail with the error code EF01152.
If the quality is improved to A, B or C, the update will be successful.

Description

Route: PUT /contact/{id}

{
   "alias": "johndoe",
   "type": "PERSON",
   "organization": "Company",
   "title": "Dr.",
   "city": "example city",
   "country": "US",
   "state": "",
   "email": "johndoe@example.com",
   "fname": "john",
   "lname": "doe",
   "address": [
      "555 example street"
   ],
   "pcode": "54321",
   "phone": "+49-321-54321",
   "fax": "+49-321-54321",
   "general": {
      "identification": {
         "number": "number",
         "authority": "government office",
         "dateOfIssue": "2017-03-01T14:31:33.5660555Z",
         "validTill": "2022-03-01T14:31:33.5660555Z"
      }
   }
}

{
    "stid": "20190628-app3-dev-11597",
    "status": {
        "code": "S0302",
        "text": "Domain contact has been updated successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Contact",
        "value": "23142212"
    }
}

Task code: 0302
Uses Contact object

<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0302</code>
		<handle>
			<alias>johndoe</alias>
			<id>1234567</id>
			<type>PERSON</type>
			<fname>john</fname>
			<lname>doe</lname>
			<title></title>
			<organization>PDA</organization>
			<address>example street</address>
			<pcode>12345</pcode>
			<city>example city</city>
			<state></state>
			<country>US</country>
			<phone>+1-12345-12345</phone>
			<fax>+1-12345-12345</fax>
			<email>johndoe@example.com</email>
			<protection>B</protection>
			<nic_ref>de</nic_ref>
			<nic_ref>com</nic_ref>
			<nic_ref>net</nic_ref>
			<remarks></remarks>
			<extension>
				<gender></gender>
				<idnumber></idnumber>
				<vatnumber></vatnumber>
				<trademark_name></trademark_name>
				<trademark_number></trademark_number>
				<trademark_country></trademark_country>
				<trademark_regdate></trademark_regdate>
				<trademark_appdate></trademark_appdate>
				<companynumber></companynumber>
				<birthday></birthday>
				<birthplace></birthplace>
				<birthcountry></birthcountry>
			</extension>
			<confirm_owner_consent>1</confirm_owner_consent>
		</handle>
		<reply_to>customer@example.com</reply_to>
	</task>
</request>

<response>
	<result>
		<data/>
		<status>
			<code>S0302</code>
			<text>Domain contact has been updated successfully.</text>
			<type>success</type>
			<object>
				<type>user</type>
				<value>customer</value>
			</object>
		</status>
	</result>
	<stid>20160615-app4-151275</stid>
</response>