Error Codes

Your application should check for error code responses from our API - do not assume that a query was successful. Error responses can be produced by using an incorrect API key, leaving out required extra parameters, providing incorrectly formatted values or an internal API error.

Below is a list of all possible error codes, what they mean and their solutions.

4XX - Authentication Error

400 - Invalid query or query not specified
```
<results code="400">
     <msg>Invalid query or query not specified</msg>
    </results>
    
```
Meaning: The query parameter has not been provided or you have provided an invalid value.

Solution: Check that you have included the key parameter in your query. Also check the spelling of the function value by checking the appropriate manual page and that there are no spaces before or after the value.
401 - Invalid API key
```
<results code="401">
     <msg>Invalid API key</msg>
    </results>
    
```
Meaning: Our API cannot be accessed as your API key is not valid or has not been provided.

Solution: Make sure you have included a valid API key via the key parameter. If you are correctly passing an API key, your API key may have been changed or deactivated. Contact your account manager or support for more information.
402 - To register a domain on Above.com, you must first verify your account
```
<results code="402">
     <msg>To register a domain on Above.com, you must first verify your account</msg>
    </results>
    
```
Meaning: Our API cannot be accessed as your account is not verified.

Solution: Make sure you have verified your Above.com account. If you have been verified Above.com account and still facing the issue. Contact your account manager or support for more information.

5XX - General Errors

500 - System unavailable
```
<results code="500">
     <msg>System unavailable</msg>
    </results>
    
```
Meaning: Indicates an internal error. This could be caused by our servers being overloaded or scheduled maintenance.

Solution: Try again in a few minutes. If you continue to receive this error, please contact support.
501 - Unknown error
```
<results code="501">
     <msg>Unknown error</msg>
    </results>
    
```
Meaning: Indicates an unexpected error in our system.

Solution: Check your query is valid and contact support with details of your query so we can look into this issue.
508 - Insufficient balance
```
<results code="508">
     <msg>Insufficient balance</msg>
    </results>
    
```
Meaning: You have tried to register, renew, restore or transfer a domain, but did not have a sufficient Above.com account balance.

Solution: Use the Add Funds API function to top up your account if you have a credit card on file. Otherwise manually add funds by using the regular Above.com Registrar website.
509 - Specified domain is not in your account
```
<results code="509">
     <msg>Specified domain is not in your account</msg>
    </results>
    
```
Meaning: The domain specified is not in your Above.com account.

Solution: You may have already pushed the domain to another account. If you have multiple Above.com accounts, check you are using the API key that corresponds to the correct account.
510 - Domain not specified or invalid domain
```
<results code="510">
     <msg>Domain not specified or invalid domain</msg>
    </results>
    
```
Meaning: You did not pass the domain parameter or provided an invalid value.

Solution: Check the spelling of the domain parameter and check the value is correctly URL encoded and does not contain any spaces.
512 - Domain extension must be specified
```
<results code="512">
     <msg>Domain extension must be specified</msg>
    </results>
    
```
Meaning: You passed a domain via the domain parameter but did not provide a valid domain extention.

Solution: Check the domain provided via the domain parameter and check the value is correctly URL encoded and does not contain any spaces.
514 - Domain is pending update or registrar/registry locked
```
<results code="514">
     <msg>Domain is pending update or registrar/registry locked</msg>
    </results>
    
```
Meaning: You attempted to update, push, update DNS or renew a domain that has a pending update or is locked at the registrar or registry level.

Solution: Check the status of the domain via the Above.com Registrar website. If the domain is pending update, this update should be completed within a few minutes. Registrar/registry locks are usually due to pending legal disputes and cannot be removed. Please contact support for more details.
532 - Multiple connections to API not allowed
```
<results code="532">
     <msg>Multiple connections to API not allowed</msg>
    </results>
    
```
Meaning: You attempted a second register API query while one was already running.

Solution: Multiple connection attempts, using the register API command are rejected. See the Usage Limits manual page for more information.

6XX - Register Function Errors

601 - Registration failed - domain already registered
```
<results code="601">
     <msg>Registration failed - domain already registered</msg>
    </results>
    
```
Meaning: Indicates that this domain has already been registered.

Solution: You may have already registered this domain or it could be registered by someone else.
602 - Registration failed - internal error
```
<results code="602">
     <msg>Registration failed - internal error</msg>
    </results>
    
```
Meaning: Indicates an internal error. This could be caused by our servers being overloaded or scheduled maintenance.

Solution: Try again in a few minutes. If you continue to receive this error, please contact support.
604 - Domain already queued to be registered
```
<results code="604">
     <msg>Domain already queued to be registered</msg>
    </results>
    
```
Meaning: You have already attempted to register this domain and it is pending registration.

Solution: The domain is usually registered with the registry within a few minutes. If you continue to receive this error, please contact support.
605 - TLD not supported by Above.com
```
<results code="605">
     <msg>TLD not supported by Above.com</msg>
    </results>
    
```
Meaning: This domain TLD is not currently supported by Above.com

Solution: The domain cannot be registered at Above.com or domain cannot be transferred into Above.com
606 - No TLD default contact set
```
<results code="606">
     <msg>No TLD default contact set</msg>
    </results>
    
```
Meaning: The domain you attempted to register requires a special domain contact set (usually an address in a particular country)

Solution: Log in to the Above.com Registrar website, go to the Default Settings page and ensure you have a domain contact set for this TLD in the TLD Default Contacts section.
607 - Invalid details in domain contact
```
<results code="607">
     <msg>Invalid details in domain contact</msg>
    </results>
    
```
Meaning: The registry has rejected the registration of this domain as the domain contact contains invalid details.

Solution: Log in to the Above.com Registrar website, go to the Default Settings page and ensure you have a valid domain contacts set for your account and, if applicable, this TLD in the TLD Default Contacts section.
608 - Domain not available
```
<results code="608">
     <msg>Domain not available</msg>
    </results>
    
```
Meaning: The registry has rejected the registration of this domain as the domain not available for registration.

Solution: Log in to the Above.com Registrar website, go to Register - Dashboard page and check if domain is available for register.
609 - Registration failed - register limit reached
```
<results code="609">
     <msg>Registration failed - register limit reached</msg>
    </results>
    
```
Meaning: Indicates your domain register limit is reached.

Solution: If you want this limit to be lifted, please contact support.
610 - Registration failed - register function paused
```
<results code="610">
     <msg>Registration failed - register function paused</msg>
    </results>
    
```
Meaning: Indicates your domain register function is paused.

Solution: Please contact support to enable register function.

7XX - Privacy Function Errors

701 - Privacy value not specified. Please specify on or off
```
<results code="701">
     <msg>Privacy value not specified. Please specify on or off</msg>
    </results>
    
```
Meaning: The set_privacy parameter was not specified.

Solution: Check the spelling of the parameter set_privacy.
702 - Privacy value invalid. Please specify on or off
```
<results code="702">
     <msg>Privacy value invalid. Please specify on or off</msg>
    </results>
    
```
Meaning: The set_privacy parameter was specified, however the value was invalid.

Solution: Accepted values for the set_privacy parameter are "on" and "off".
704 - Privacy not allowed for this TLD
```
<results code="704">
     <msg>Privacy not allowed for this TLD</msg>
    </results>
    
```
Meaning: Privacy is not allowed for this TLD.

Solution: This registry may not allow privacy or there may be legal reasons preventing us from allowing privacy on domains of this TLD.

8XX - Renew Function Errors

801 - Renewal years not specified or value is not a valid number
```
<results code="801">
     <msg>Renewal years value not specified</msg>
    </results>
    
```
Meaning: You have not specified the renew_year parameter or entered an invalid value.

Solution: Make sure the renew_year parameter is included in the query and that the value is numerical. Please note that we accept 1-10 years renewal.
802 - Renew Request exceeds the registry's policy limits
```
<results code="802">
     <msg>Renew Request exceeds the registry's policy limits</msg>
    </results>
    
```
Meaning: Some registry's restrict the number of renewal that can be performed in a certain period of time.

Solution: Review registry's renewal policy to find out their restrictions. Also note that some ccTLD domains must be renewed for a minimum of 2 years.
803 - Renewal years must be 1-10 years
```
<results code="803">
     <msg>Renewal years must be 1-10 years</msg>
    </results>
    
```
Meaning: You have specified a renew_year value that is less than 1 year or more than 10 years.

Solution: We accept renewals of 1-10 years. Please adjust the value passed to the renew_year parameter.
804 - Renewal not allowed for this TLD
```
<results code="804">
     <msg>Renewal not allowed for this TLD</msg>
    </results>
    
```
Meaning: Renewals of this TLD are not allowed.

Solution: Some TLDs cannot be renewed as this is not allowed at the registry. Please turn on auto renew via the Above.com Registrar website to ensure your domains are renewed every year.

9XX - Transfer Function Errors

901 - Transfer failed - domain already at Above.com
```
<results code="901">
     <msg>Transfer failed - domain already at Above.com</msg>
    </results>
    
```
Meaning: Indicates the domain is already at Above.com or the transfer has already been completed.

Solution: This domain has already been transferred to Above.com. If you need to move it to another Above.com account, use the Push API function.
903 - Invalid EPP code specified
```
<results code="903">
     <msg>Invalid EPP code specified</msg>
    </results>
    
```
Meaning: The EPP code has not been provided or is not valid.

Solution: Ensure EPP codes are provided and correct. Correctly URL encoding EPP codes is very important as they often contain symbols.
904 - Domain already queued to be transferred
```
<results code="904">
     <msg>Domain already queued to be transferred</msg>
    </results>
    
```
Meaning: You have already initiate the transfer of this domain to Above.com

Solution: Domain transfers usually take 5 days. Ensure the domain is unlocked at the losing registrar and that the transfer has been confirmed. Please contact support if you are unsure and need us to check the status of the transfer.

10XX - Restore Function Errors

1001 - Please specify reason for restore
```
<results code="1001">
     <msg>Please specify reason for restore</msg>
    </results>
    
```
Meaning: The restore_reason parameter has not been included or the value is not valid.

Solution: Specify a reason for restoring the domain and ensure the restore_reason parameter value is correctly URL encoded.
1002 - Domain is not in redemption and cannot be restored
```
<results code="1002">
     <msg>Domain is not in redemption and cannot be restored</msg>
    </results>
    
```
Meaning: The domain is not in the redemption period and cannot be restored.

Solution: Check the expiry date and status of the domain. If the domain has expired but is not yet in redemption, you can usually use the Renew API function to reactivate the domain. If the domain is in the pending delete period, the domain cannot be restored and will soon become available to the public.
Note: UK domains can be reactivated during the redemption period by using the Renew API function.

12XX - Lock/Unlock Function Errors

1201 - Domain already locked
```
<results code="1201">
     <msg>Domain already locked</msg>
    </results>
    
```
Meaning: Indicates the domain is already client locked.

Solution: You have already locked this domain.
1202 - Domain already unlocked
```
<results code="1202">
     <msg>Domain already unlocked</msg>
    </results>
    
```
Meaning: Indicates the domain is already unlocked.

Solution: You have already unlocked this domain.
1203 - Domain is locked by registrar
```
<results code="1203">
     <msg>Domain is locked by registrar</msg>
    </results>
    
```
Meaning: Domain is locked by Above.com. You cannot unlock it.

Solution: Registrar locked domains are usually being held due to a legal dispute and cannot be unlocked. Please contact support for more information.
1204 - Domain is locked by registry
```
<results code="1204">
     <msg>Domain is locked by registry</msg>
    </results>
    
```
Meaning: Domain is locked by the registry. You cannot unlock it.

Solution: Registry locked domains are usually being held due to a legal dispute and cannot be unlocked. Please contact support for more information.
1205 - Lock not supported for TLD
```
<results code="1205">
     <msg>Lock not supported for TLD</msg>
    </results>
    
```
Meaning: This TLD does not support domain locking.

Solution: Client lock not supported by registry.
1206 - Cannot unlock domain within 60 days of transfer in
```
<results code="1206">
     <msg>Cannot unlock domain within 60 days of transfer in</msg>
    </results>
    
```
Meaning: The domain has a 60 day lock and can not be unlocked yet.

Solution: Wait the remaining time and then unlock the domain.

13XX - Update DNS Function Errors

1301 - Invalid DNS servers specified. Cannot update DNS
```
<results code="1301">
     <msg>Invalid DNS servers specified. Cannot update DNS</msg>
    </results>
    
```
Meaning: One or more of the DNS servers specified are not valid.

Solution: Ensure you are using the correct nameserver hostname. They are usually similar to ns1.abovedomains.com for example.
1303 - Invalid number of DNS servers specified
```
<results code="1303">
     <msg>Invalid number of DNS servers specified</msg>
    </results>
    
```
Meaning: You have specified too many or too few nameserver.

Solution: You need to specify at least two nameservers and a maximum of four. Nameservers need to be seperated with commas (,).
1304 - Please provide DNS servers
```
<results code="1304">
     <msg>Please provide DNS servers</msg>
    </results>
    
```
Meaning: You have not specified the dns parameter or entered an invalid value.

Solution: You need to specify at least two nameservers and a maximum of four. Nameservers need to be seperated with commas (,).
1305 - Use two different DNS servers
```
<results code="1305">
     <msg>Use two different DNS servers</msg>
    </results>
    
```
Meaning: The primary and secondary name servers you have provided are indentical.

Solution: We require at least two different name servers (up to 4) to update DNS.
1306 - Use two different DNS servers
```
<results code="1306">
     <msg>Update DNS not allowed on expired domain</msg>
    </results>
    
```
Meaning: You attempted to update DNS on an expired domain.

Solution: You will need to renew your domain before the DNS can be updated.
1307 - Custom DNS function disabled
```
<results code="1307">
     <msg>Custom DNS function disabled</msg>
    </results>
    
```
Meaning: You attempted to update DNS when custom dns function disabled.

Solution: You will need to contact your account manager or support for more information to enable custom dns function.

14XX - Add Funds Function Errors

1401 - Invalid amount specified or amount not specified
```
<results code="1401">
     <msg>Invalid amount specified or amount not specified</msg>
    </results>
    
```
Meaning: You have not specified the amount parameter or the amount you have specified is not valid.

Solution: Make sure the amount parameter is included in the query and the value is a valid number. Do not include a dollar sign or any commas. You can include cents by using a full stop (period) to denoted the decimal place.
1402 - No credit card on file
```
<results code="1402">
     <msg>No credit card on file</msg>
    </results>
    
```
Meaning: You do not have a credit card saved on file.

Solution: You must have a credit card saved to your Above.com account to use this function. You can add a credit card by logging in to your Above.com account, clicking Account in the top-right, clicking the Billing Details tab, then the Change Credit Card Details button.
1403 - Transaction declined
```
<results code="1403">
     <msg>Transaction declined</msg>
    </results>
    
```
Meaning: The transaction was declined and funds were not added to your account.

Solution: Check your credit card on file is still current. If your credit card number is correct, please check with your bank to find out why the transaction was declined.

15XX - Push Function Errors

1501 - To account not specified
```
<results code="1501">
     <msg>To account not specified</msg>
    </results>
    
```
Meaning: You have not specified the toaccount parameter.

Solution: Make sure the toaccount parameter is included in the query and the value is correctly URL encoded.
1502 - Comment not specified or not ASCII
```
<results code="1502">
     <msg>Comment not specified or not ASCII</msg>
    </results>
    
```
Meaning: You have not specified the comment parameter or it contains non ASCII characters.

Solution: Make sure the comment parameter is included in the query, it contains only ASCII characters and the value is correctly URL encoded.
1503 - Invalid username or to account does not exist
```
<results code="1503">
     <msg>Invalid username or to account does not exist</msg>
    </results>
    
```
Meaning: The receiving account is invalid or does not exist.

Solution: Check the account is valid and that the value is correctly URL encoded.
1504 - You cannot push domains to your own account
```
<results code="1504">
     <msg>You cannot push domains to your own account</msg>
    </results>
    
```
Meaning: You have attempted to push domains to your own account.

Solution: If you have multiple Above.com accounts, you may be using the incorrect API key.

16XX - Request EPP Function Errors

1601 - EPP code unsupported by registry
```
<results code="1601">
     <msg>EPP code unsupported by registry</msg>
    </results>
    
```
Meaning: EPP code is not provided as this transfer method is unsupported by registry.

Solution: Transfer of some TLDs cannot be achived using the EPP transfer code and must be completed at the registry instead.

20XX - Manage Domains Function Errors

2001 - No domains found
```
<results code="2001">
     <msg>No domains found</msg>
    </results>
    
```
Meaning: There are no domains in your or no domains were found for your search.

Solution: If you are using the offset parameter, ensure that you have not exceed the total number of domains in your account. If you are using the domain parameter, the domains may not be correct or in a different account.
2002 - Invalid limit
```
<results code="2002">
     <msg>Invalid limit. Accepted values are 1-1000</msg>
    </results>
    
```
Meaning: The limit value passed is invalid or out of range.

Solution: Accepted values are 0 or greater. Negative numbers and decimals are not accepted.
2003 - Invalid offset
```
<results code="2003">
     <msg>Invalid offset. Accepted values are 0 or greater</msg>
    </results>
    
```
Meaning: The offset value passed is invalid or out of range.

Solution: Accepted values are 1 to 1,000 (do not include any commas). Negative numbers and decimals are not accepted.
2004 - Invalid sort_by value
```
<results code="2004">
     <msg>Invalid sort_by value. Accepted values are domain, expiry, created</msg>
    </results>
    
```
Meaning: The sort_by value specified is invalid.

Solution: Please check spelling of the value. Accepted values are "domain", "expiry" and "created".

2005 - Invalid order value

<results code="2005">
     <msg>Invalid order value. Accepted values are asc, desc</msg>
    </results>

Meaning: The order value specified is invalid.

Solution: Accepted values are "asc" and "desc".

Portfolio Manager

My Domains

Monetization

Sell Domains

Offers Received

Registrar

Reports

Common Actions

Monetization API

Queries

Registrar API