Table of Contents

Function

The request type DomainTransfer starts an incoming domain transfer.

You can also use this task to start a domain transfer combined with a change of ownership. This is called TRADE for some TLDs.

Description

Route: POST /domain/_transfer

Request 
{
  "name": "example.com",

  "ownerc": {
    "id": 9925345
  },
  "adminc": {
    "id": 9925345
  },
  "techc": {
    "id": 9925345
  },
  "zonec": {
    "id": 9925345
  },
  "nameServers": [
    {
      "name": "ns1.example.com"
    },
    {
      "name": "ns2.example.com"
    }
  ],
  "dnssecData": [
      {
          "flags": 257,
          "algorithm" 3,
          "protocol": 5,
          "publicKey": "key..."       
      }
  ], 
  "ignoreWhois": 1,
  "privacy": 1,
  "confirmOrder": 1,
  "confirmOwnerConsent": 1,
  "authinfo": "CTA2aSA5hFLu+hX22222222",
 }



Response 
{
"stid": "20190704-app3-dev-7945",
"messages": [
{
"text": "Domain contact has been successfully created.",
"objects": [
{
"type": "handle",
"value": "23152776"
}
],
"code": "S0301",
"status": "SUCCESS"
},
{
"text": "Domain contact has been successfully created.",
"messages": [
{
"text": "This domain contact already exists and is used. A new contact was not created.",
"code": "MSG03003",
"status": "NOTICE"
}
],
"objects": [
{
"type": "handle",
"value": "23152776"
}
],
"code": "S0301",
"status": "SUCCESS"
},
{
"text": "Domain contact has been successfully created.",
"messages": [
{
"text": "This domain contact already exists and is used. A new contact was not created.",
"code": "MSG03003",
"status": "NOTICE"
}
],
"objects": [
{
"type": "handle",
"value": "23152776"
}
],
"code": "S0301",
"status": "SUCCESS"
}
],
"status": {
"code": "N0104",
"text": "The domain transfer was startet successfully.",
"type": "NOTIFY"
},
"object": {
"type": "Domain",
"value": "example.com"
},
"data": [
{
"created": "2019-07-04T09:16:24.000+0200",
"updated": "2019-07-04T09:16:23.000+0200",
"owner": {
"context": 4,
"user": "exampleuser"
},
"updater": {
"context": 4,
"user": "exampleuser"
},
"status": "RUNNING",
"execution": "2019-07-04T09:16:23.000+0200",
"id": 4297545556
}
]
}

Task Code: 0104
Uses Domain object

Single Request

Request 
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code></code>
		<domain>
			<name>example.com</name>
			<authinfo>9Vz6U72V/RycSZW</authinfo>
			<ignore_whois>1</ignore_whois>
			<ownerc>9925345</ownerc>
			<adminc>9925345</adminc>
			<techc>9925345</techc>
			<zonec>9925345</zonec>
			<nserver>
				<name>ns1.example.com</name>
			</nserver>
			<nserver>
				<name>ns2.example.com</name>
			</nserver>
			<dnssec>
				<flags>257</flags>
				<protocol>3</protocol>
				<algorithm>5</algorithm>
				<publickey>key...</publickey>
			</dnssec>
			<use_privacy>1</use_privacy>
			<confirm_order>1</confirm_order>
			<confirm_owner_consent>1</confirm_owner_consent>
		</domain>
		<reply_to>customer@example.com</reply_to>
		<ctid></ctid>
	</task>
</request>
Response 
<response>
	<result>
		<status>
			<code>N0104</code>
			<text>The domain transfer was startet successfully.</text>
			<type>notify</type>
		</status>
	</result>
</response>

Bulk Request

Request 
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0104</code>
		<default>
			<ignore_whois>1</ignore_whois>
			<ownerc>9925345</ownerc>
			<adminc>9925345</adminc>
			<techc>9925346</techc>
			<zonec>9925346</zonec>
			<nserver>
				<name>ns1.example.com</name>
			</nserver>
			<nserver>
				<name>ns2.example.com</name>
			</nserver>
			<confirm_owner_consent>1</confirm_owner_consent>
		</default>
		<domain>
			<name>example.com</name>
			<authinfo>9Vz6U72V/RycSZW</authinfo>
		</domain>
		<domain>
			<name>example.org</name>
			<authinfo>2V/RycSZW9Vz6U7</authinfo>
		</domain>
		<ctid>1234567</ctid>
	</task>
</request>
Response 
<response>
	<result>
		<status>
			<code>N0104</code>
			<text>The domain transfer was startet successfully.</text>
			<type>notify</type>
		</status>
	</result>
</response>

Possible Error Messages

  • EF01040 - This SLD is not a valid Internationalizing Domain Name (IDN).
  • EF010401 - The required IDN name variant is registered through another registrar
  • EF0104011 - It is not permitted to do an ownerchange during a transfer for this TLD.
  • EF0104026 - Push request could not be found.
  • EF01041 - Only the master may use the key use_nic_member_label.
  • EF010410 - The OwnerC domain contact ID could not be created automatically. Please contact our support team to start the transfer.
  • EF01042 - User is not authorized for this NIC member label.
  • EF01043 - This domain is already under your administration.