- Home
- API reference
- API documentation (JSON/XML)
- Tasks
- Transfer tasks
Domain transfer
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
{
"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",
}{
"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>
<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>
<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.