Used to transfer a domain name to your account
For more information about DNS zone operations and the interactions with domains see our Knowledge Base.
Name | Type | Description | Restrictions |
---|---|---|---|
Domain Name | String | The domain name |
|
Name | Type | Required / Optional | Description | Restrictions |
---|---|---|---|---|
Quote | Boolean | Optional | If true, validate the request and request a quote for the action |
Name | Type | Required / Optional | Description | Restrictions |
---|---|---|---|---|
Customer | String | Required | The customer handle |
|
Registrant | String | Required | The handle of the contact to use as registrant |
|
Privacy protect | Boolean | Optional | If set to True, privacy protect will be enabled, defaults to the 'Privacy Protect' setting in your account | |
Period | Integer | Optional | The period to add to the domain during the transfer in months, defaults to the minimum period allowed by the registry | |
Auth code | String | Optional | The current auth code for the domain name |
|
Auto renew | Boolean | Optional | If set to False, the domain will not be auto renewed upon expiration, defaults to True | |
Name serves | List <String> | Optional |
List of name servers
|
|
Preferred FOA contacts | List <Enum> | Optional | Specify the preferred contacts to send the FOA to. Please note that this setting may be overruled because of TLD policy requirements. |
Possible values:
|
Designated agent | Enum | Optional | Indicates for whom you are acting as a designated agent. If a registry does not allow you to be designated agent or interaction with the registrant is still required this parameter is silently ignored. You cannot act as designated agent for the old registrant until the domainis in your account. To use this field with any other value then "NONE" the requesting user must have the "DESIGNATED_AGENT" permission. |
Possible values:
|
zone | zone | Optional | DNS template to use for the domain name, transform an existing zone of the specified service into a managed zone or creates a new managed zone if not found. Vanity name servers can be specified on the "ns" field. |
|
contacts | List < contacts > | Optional | Domain contacts and their role | |
keyData | List < keyData > | Optional |
DNSSEC key data
|
|
billables | List < billables > | Optional | Acknowledgment of billables for this request |
Name | Type | Required / Optional | Description | Restrictions |
---|---|---|---|---|
Service | Enum | Optional | DNS service to provision, defaults to BASIC |
Possible values:
|
Template | String | Optional | In case of a new zone, the template to use |
|
Link | Boolean | Optional | Unless false, the zone is linked to the template | |
Master | String | Optional | In case of a new zone, the IP address of the (hidden) master |
|
DNSSEC | Boolean | Optional | In case of a new zone, provision zone with DNSSEC |
Name | Type | Required / Optional | Description | Restrictions |
---|---|---|---|---|
protocol | Integer | Required | The DNSSEC protocol |
Possible values:
|
flags | Integer | Required | The DNSSEC flags |
Possible values:
|
algorithm | Integer | Required | The DNSSEC algorithm |
Possible values:
|
Public key | String | Required | The base64 encoded public key |
|
Name | Type | Required / Optional | Description | Restrictions |
---|---|---|---|---|
Product | String | Required | The product |
|
Action | Enum | Required | The action |
Possible values:
|
Quantity | Integer | Optional | The maximum quantity, default 1 |
Name | Type | Required / Optional | Description |
---|---|---|---|
Domain Name | String | Required | The domain name |
The status | Enum | Required |
The status of the transfer
Possible values:
|
Requested date | Timestamp | Required | The date the transfer was initiated |
Expire date | Timestamp | Optional | Expiration date of the transfer after completion, only present when status is "completed" |
Transfer type | Enum | Required |
The type of transfer
Possible values:
|
The process ID of the transfer | Integer | Required | The unique process identifier for this transfer |
Name | Type | Required / Optional | Description |
---|---|---|---|
Domain Name | String | Required | The domain name |
The status | Enum | Required |
The status of the transfer
Possible values:
|
Requested date | Timestamp | Required | The date the transfer was initiated |
Action date | Timestamp | Optional | The date the current status will expire |
Transfer type | Enum | Required |
The type of transfer
Possible values:
|
The process ID of the transfer | Integer | Required | The unique process identifier for this transfer |
Besides the generic errors these specific error responses can be expected.
Type | Status | Description |
---|---|---|
BillableAcknowledgmentNeededException | 400 Bad Request |
POST
/v2/domains/domainName/transfer
Content-Type: application/json
{}