Start a transfer for a specified domain and customer. Returns transfer information. Be sure to save the id. The transfer itself will be processed by Backoffice. You can request the transfer status by calling GET domain/transfer/{domain_transfer_id}.
https://backoffice.hostcontrol.com/api/v1/domain-transfer
| Parameter | Required? | Description | Example value |
|---|---|---|---|
| customer | required | Id of the customer. | 35 |
| domain | required | Domain name to transfer. | exampledomainnnn.com |
| authcode | optional | Authcode for the domain name. | Z0aCJAS09~dw3 |
| interval | optional | Interval of the domain name in months. Defaults to 12 and currently, 12 is the only supported value for this setting. |
12 |
POST https://backoffice.hostcontrol.com/api/v1/domain-transfer
POST Data
{
"customer": 35,
"domain": "exampledomainnerwer.com",
"authcode": "Z0aCJAS09~dw3"
}
Result
{
"result": {
"status": "wait_for_authcode",
"direction": "in",
"updated": "2013-10-23T09:45:13.086506+00:00",
"is_privacy_protect_enabled": true,
"domain": null,
"id": 41,
"customer": {
"is_enabled": true,
"updated": "2013-10-22T11:46:14.077236+00:00",
"is_dns_management_enabled": true,
"created": "2013-10-22T11:46:14.077191+00:00",
"primary_contact": {
"city": "Groningen",
"fax": "",
"voice": "+31.612345678",
"updated": "2013-10-22T11:46:14.084454+00:00",
"name": "John Doe",
"created": "2013-10-22T11:46:14.084419+00:00",
"gender": null,
"organisation": "",
"extra": {},
"zipcode": "1234AA",
"email": "john@doe.com",
"state": "Groningen",
"address": "Street 123",
"domains": [
"exampledomainnnnnn.com",
"exampledomainnnn.com",
"iasdjoaisjdasoijd.com",
"testdomainnn.com"
],
"vat_number": null,
"country": {
"code": "NL",
"name": "Netherlands"
},
"type": "primary",
"id": 55
},
"is_receiving_support_notifications": true,
"is_ns_management_enabled": true,
"is_verified": true,
"id": 35
},
"name": "exampledomainnerwer.com",
"created": "2013-10-23T09:45:13.086450+00:00",
"authcode": "Z0aCJAS09~dw3",
"interval": 12,
"tld": {
"name": "com"
}
},
"success": true
}