Domain Transfer Initiate
Resource path /Domain/Transfer/Initiate
https://testapi.internet.bs/Domain/Transfer/Initiate?apiKey=testapi&password=testpass&Domain=example.com&.....
The command is intended to initiate an incoming domain name transfer.
The parameters are almost identical to those used for /Domain/Create, however some extra parameters are optionally offered. Please pay attention as the parameter transferAuthInfo is not always optional. For reference see comments in the table below. Because of some structural differences between domain extensions, the parameter Period is not accepted; once a transfer has been completed you can use /Domain/Renew to extend the expiration if needed.
HTTPS POST/GET Request parameters:
| Parameter name | Description |
ApiKey |
The API key that we provided to you when you requested API access for your account |
Password |
The password we provided when you requested API access for your account |
Domain |
Domain name including extension (ex: example.com) |
See /Domain/Create for contact related parameters and for .tel specific parameters |
|
Ns_list |
Please refer to /Domain/Create for the correct format |
transferAuthInfo |
The auth info (also transfer password, transfer secret, epp auth info, etc...). Depending on the domain that you are transferring might be optional however for .com, .net, .info, .biz, .org, .mobi the field is mandatory. |
registrarLock |
To prevent your domain from being stolen the default value is ENABLED. You can set ENABLED or DISABLED. You need to change it to DISABLED just before you need to transfer your domain away. For some domains such as .eu or .fr the value is NOTADMITTED as it is not possible to set such a lock at the Registry level. |
privateWhois |
By default it is set to DISABLED, possible values are FULL, PARTIAL and DISABLED. |
discountCode |
A discount code if you have one |
senderEmail |
The email to be used as sender when sending the initial authorization for domain transfer as required by ICANN. If not provided but needed your reseller user email account will be used as sender. |
senderName |
The name used in the body of the initial authorization for the domain transfer email. If not provided but needed, the account user name will be used. |
renewAfterTrasnfer |
By default it's set to NO, possible values are YES, NO. If set YES, then the domain will be renewed for one year once the transfer gets completed. This parameter is valid for only .DE/.NL domains transfers. If you start the transfer for a domain close to end of billing cycle then the value must be set to "YES" because at the end of the billing period you need to renew the domain in order to avoid having it deleted just after transfer. |
ResponseFormat |
This specifies how the response will be returned. Possible values are TEXT, JSON and XML. |
Returned data:
TRANSACTID=Transaction ID reference
Domain=Domain name
Example:
Result:
currency=USD
price=6.99
product_0_price=6.99
product_0_status=SUCCESS
product_0_domain=example.eu