DeleteDomain - Amazon Route 53


This operation deletes the specified domain. This action is permanent. For more information, see Deleting a domain name registration.

To transfer the domain registration to another registrar, use the transfer process that’s provided by the registrar to which you want to transfer the registration. Otherwise, the following apply:

  1. You can’t get a refund for the cost of a deleted domain registration.

  2. The registry for the top-level domain might hold the domain name for a brief time before releasing it for other users to register (varies by registry).

  3. When the registration has been deleted, we'll send you a confirmation to the registrant contact. The email will come from or

Request Syntax

{ "DomainName": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.


Name of the domain to be deleted.

Type: String

Length Constraints: Maximum length of 255.

Required: Yes

Response Syntax

{ "OperationId": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.

Type: String

Length Constraints: Maximum length of 255.


For information about the errors that are common to all actions, see Common Errors.


The request is already in progress for the domain.

HTTP Status Code: 400


The requested item is not acceptable. For example, for APIs that accept a domain name, the request might specify a domain name that doesn't belong to the account that submitted the request. For AcceptDomainTransferFromAnotherAwsAccount, the password might be invalid.

HTTP Status Code: 400


The top-level domain does not support this operation.

HTTP Status Code: 400


Amazon Route 53 does not support this top-level domain (TLD).

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: