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

Domain ownerchange

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

Function

The DomainOwnerchange task exchanges the OwnerC domain contact when the domain owner changes.

DomainOwnerchange can only be used for some TLDs. You can use the task domain transfer to start a domain transfer in combination with an owner change. This is called a "trade" for some TLDs.

Description

Route: POST /domain/_ownerChange

{
   "name": "00000-icann-test-16b.com",
   "confirmOwnerConsent": "true",
   "ownerc": {
      "id": "21642636"
   }
}

{
   "stid": "20200820-app2-dev-15793",
   "messages": [
      {
         "text": "The execution was delegated to the domain update task.",
         "objects": [
            {
               "type": "domain",
               "value": "example.eu"
            }
         ],
         "code": "MSG0102",
         "status": "NOTICE"
      }
   ],
   "status": {
      "code": "N0104010",
      "text": "Owner change has been accepted.",
      "type": "NOTIFY"
   },
   "object": {
      "type": "Domain",
      "value": "example.eu"
   },
   "data": [
      {
         "created": "2020-08-20T09:51:23.000+0200",
         "updated": "2020-08-20T09:51:22.000+0200",
         "owner": {
            "context": 4,
            "user": "customer"
         },
         "updater": {
            "context": 4,
            "user": "customer"
         },
         "status": "RUNNING",
         "execution": "2020-08-20T09:51:22.000+0200",
         "id": 4298093416
      }
   ]
}

Task code: 0104010
Uses Domain object

<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0104010</code>
		<domain>
			<name>example.eu</name>
			<ownerc>9925345</ownerc>
			<confirm_owner_consent>1</confirm_owner_consent>
		</domain>
	</task>
</request>

<response>
	<result>
		<status>
			<code>N0104010</code>
			<text>Owner change has been accepted.</text>
			<type>notify</type>
		</status>
	</result>
</response>