Help Center
Login Sign up
  1. Home
  2. API reference
  3. API documentation (JSON/XML)
  4. Tasks
  5. Transfer tasks

Domain transfer

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

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
}
]
}

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.