Deleting a Domain Name
Synopsis
| Description: | A command to delete a domain name. |
| URL: | https://toolkit.centralnic.com/srv/delete_domain |
| HTTP Method: | POST |
| Requires Authentication?: | Yes |
| Requires SSL?: | Yes |
| Query Parameters: | |
| test | The test flag (eg 1 or 0, optional) |
| user | Your Registrar Handle ID |
| password | Your encrypted Registrar password |
| domain | The domain name (eg example.uk.com) |
| reason | The reason code |
Using this command, you can delete an unwanted domain name. However, you must supply a reason code in order for the deletion to take place. The currently available codes are listed below:
| Code | Meaning |
|---|---|
| R1 | Payment not received |
| R2 | Fraudulent Registration |
| R3 | Domain no longer required by registrant |
| R4 | Domain registered in error |
You can only delete domain names if:
- you are the Billing Contact for the domain, AND
- the status of the domain name is 'Live' or 'On Hold', AND
- the domain has an unpaid renewal aginst it, OR
- the registration date is the same as the expiry date (applies for newly-registered domains only)
In accordance with our policy, an e-mail will be sent to the domain's Client Contact informing them that the domain has been deleted.
Response Format
The response from the server will be of the form:
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 0 Message: Domain has been deleted.
In the event of an error, the server will return something like this:Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 1 Message: Domain not found.