API Queries - Restore
The restore API function restores a domain that has expired and is in redemption. Currently the restore function is not supported by all TLDs. Restoring a domain that has expired attracts a higher fee than registration or renewal. Use the Check Pricing and Check Balance functions to check the domain restoration cost and that your account balance is adequate before proceeding. Additional parameters are required for this function.
Note: UK domains can be reactivated during the redemption period by using the Renew API function.
Additional Parameters
- domain - Domain name to restore. Note: http://www. should not be included.
- restore_reason - Provide the reason you need to restore the domain(s).
Your API key is required and all values should be correctly URL encoded.
Example
In the below example, we will restore the domain "mybusiness.com" with the reason "Webmaster forgot to renew" (domain=mybusiness.com&restore_reason=Webmaster forgot to renew). Note that all values should be correctly URL encoded, particually the reason value (see below).
Query
https://www.above.com/registrar/api/query.html?key=APIKEY&query=restore&domain=mybusiness.com&restore_reason=Webmaster%20forgot%20to%20renew
Response
<results code="100" />
Error Codes
Possible error responses for this function are:
- 508 - Insufficient balance
- 509 - Specified domain is not in your account
- 510 - Domain not specified or invalid domain
- 512 - Domain extension must be specified
- 1001 - Please specify reason for restore
- 1002 - Domain is not in redemption and cannot be restored
- General errors, such as 401 - Invalid API key or 500 - System unavailable.
