API Queries - Transfer

The transfer API function transfers a domain from another registrar into your Above.com account. When you transfer a domain into Above.com Registrar, you will need to pay the renewal fee. Use the Check Pricing and Check Balance functions to check the renewal cost and that your account balance is adequate before proceeding. If you want to move a domain from one Above.com account to another, you need to use the Push function instead. Additional parameters are required for this function.

Additional Parameters

• domain - Domain name to transfer followed by a colon (:) and the EPP code. You can transfer multiple domains by seperating them with a comma (,) Note: http://www. should not be included.
• epp_code - Domain EPP code (also known as transfer code, auth code or authorization code)

Your API key is required and all values should be correctly URL encoded.

Example

In the below example, we will transfer the domain "pencils.com" with the EPP code "nB$/4bVm" (domain=pencils.com&epp_code=nB$/4bVm). Note these values should be correctly URL encoded before querying the API, particually EPP code value (see below).

Query

https://www.above.com/registrar/api/query.html?key=APIKEY&query=transfer&domain=pencils.com&epp_code=nB%24%2F4bVm

Response

<results code="100" />
          

Example 2

In this example we will attempt to transfer a domain that is already at Above.com. The transfer will be rejected and an error shown in the response XML. We will use the domains "boots.com" with the EPP code "2n?tEkfgglG" (domain=boots.com&epp_code=2n?tEkfgglG). Note these values should be correctly URL encoded before querying the API, particually EPP code value (see below).

Query

https://www.above.com/registrar/api/query.html?key=APIKEY&query=transfer&domain=boots.com&epp_code=2n%3FtEkfgglG

Response

<results code="901">
           <msg>Transfer failed - domain already at Above.com</msg>
          </results>
          

Error Codes

Possible error responses for this function are:

• 508 - Insufficient balance
• 510 - Domain not specified or invalid domain
• 512 - Domain extension must be specified
• 605 - TLD not supported by Above.com
• 901 - Transfer failed - domain already at Above.com
• 903 - Invalid EPP code specified
• 904 - Domain already queued to be transferred
• General errors, such as 401 - Invalid API key or 500 - System unavailable.