# Amazon Route 53 domain registration
<a name="API_Operations_Amazon_Route_53_Domains"></a>

The following actions are supported by Amazon Route 53 domain registration:
+  [AcceptDomainTransferFromAnotherAwsAccount](API_domains_AcceptDomainTransferFromAnotherAwsAccount.md) 
+  [AssociateDelegationSignerToDomain](API_domains_AssociateDelegationSignerToDomain.md) 
+  [CancelDomainTransferToAnotherAwsAccount](API_domains_CancelDomainTransferToAnotherAwsAccount.md) 
+  [CheckDomainAvailability](API_domains_CheckDomainAvailability.md) 
+  [CheckDomainTransferability](API_domains_CheckDomainTransferability.md) 
+  [DeleteDomain](API_domains_DeleteDomain.md) 
+  [DeleteTagsForDomain](API_domains_DeleteTagsForDomain.md) 
+  [DisableDomainAutoRenew](API_domains_DisableDomainAutoRenew.md) 
+  [DisableDomainTransferLock](API_domains_DisableDomainTransferLock.md) 
+  [DisassociateDelegationSignerFromDomain](API_domains_DisassociateDelegationSignerFromDomain.md) 
+  [EnableDomainAutoRenew](API_domains_EnableDomainAutoRenew.md) 
+  [EnableDomainTransferLock](API_domains_EnableDomainTransferLock.md) 
+  [GetContactReachabilityStatus](API_domains_GetContactReachabilityStatus.md) 
+  [GetDomainDetail](API_domains_GetDomainDetail.md) 
+  [GetDomainSuggestions](API_domains_GetDomainSuggestions.md) 
+  [GetOperationDetail](API_domains_GetOperationDetail.md) 
+  [ListDomains](API_domains_ListDomains.md) 
+  [ListOperations](API_domains_ListOperations.md) 
+  [ListPrices](API_domains_ListPrices.md) 
+  [ListTagsForDomain](API_domains_ListTagsForDomain.md) 
+  [PushDomain](API_domains_PushDomain.md) 
+  [RegisterDomain](API_domains_RegisterDomain.md) 
+  [RejectDomainTransferFromAnotherAwsAccount](API_domains_RejectDomainTransferFromAnotherAwsAccount.md) 
+  [RenewDomain](API_domains_RenewDomain.md) 
+  [ResendContactReachabilityEmail](API_domains_ResendContactReachabilityEmail.md) 
+  [ResendOperationAuthorization](API_domains_ResendOperationAuthorization.md) 
+  [RetrieveDomainAuthCode](API_domains_RetrieveDomainAuthCode.md) 
+  [TransferDomain](API_domains_TransferDomain.md) 
+  [TransferDomainToAnotherAwsAccount](API_domains_TransferDomainToAnotherAwsAccount.md) 
+  [UpdateDomainContact](API_domains_UpdateDomainContact.md) 
+  [UpdateDomainContactPrivacy](API_domains_UpdateDomainContactPrivacy.md) 
+  [UpdateDomainNameservers](API_domains_UpdateDomainNameservers.md) 
+  [UpdateTagsForDomain](API_domains_UpdateTagsForDomain.md) 
+  [ViewBilling](API_domains_ViewBilling.md) 

# AcceptDomainTransferFromAnotherAwsAccount
<a name="API_domains_AcceptDomainTransferFromAnotherAwsAccount"></a>

Accepts the transfer of a domain from another AWS account to the currentAWS account. You initiate a transfer between AWS accounts using [TransferDomainToAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_TransferDomainToAnotherAwsAccount.html).

If you use the AWS CLI command at [accept-domain-transfer-from-another-aws-account](https://docs.aws.amazon.com/cli/latest/reference/route53domains/accept-domain-transfer-from-another-aws-account.html), use JSON format as input instead of text because otherwise AWS CLI will throw an error from domain transfer input that includes single quotes.

Use either [ListOperations](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ListOperations.html) or [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html) to determine whether the operation succeeded. [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html) provides additional information, for example, `Domain Transfer from Aws Account 111122223333 has been cancelled`. 

## Request Syntax
<a name="API_domains_AcceptDomainTransferFromAnotherAwsAccount_RequestSyntax"></a>

```
{
   "DomainName": "string",
   "Password": "string"
}
```

## Request Parameters
<a name="API_domains_AcceptDomainTransferFromAnotherAwsAccount_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_AcceptDomainTransferFromAnotherAwsAccount_RequestSyntax) **   <a name="Route53Domains-domains_AcceptDomainTransferFromAnotherAwsAccount-request-DomainName"></a>
The name of the domain that was specified when another AWS account submitted a [TransferDomainToAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_TransferDomainToAnotherAwsAccount.html) request.   
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [Password](#API_domains_AcceptDomainTransferFromAnotherAwsAccount_RequestSyntax) **   <a name="Route53Domains-domains_AcceptDomainTransferFromAnotherAwsAccount-request-Password"></a>
The password that was returned by the [TransferDomainToAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_TransferDomainToAnotherAwsAccount.html) request.   
Type: String  
Required: Yes

## Response Syntax
<a name="API_domains_AcceptDomainTransferFromAnotherAwsAccount_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_AcceptDomainTransferFromAnotherAwsAccount_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_AcceptDomainTransferFromAnotherAwsAccount_ResponseSyntax) **   <a name="Route53Domains-domains_AcceptDomainTransferFromAnotherAwsAccount-response-OperationId"></a>
Identifier for tracking the progress of the request. To query the operation status, use [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html).  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_AcceptDomainTransferFromAnotherAwsAccount_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DomainLimitExceeded **   
The number of domains has exceeded the allowed threshold for the account.    
 ** message **   
The number of domains has exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_AcceptDomainTransferFromAnotherAwsAccount_Examples"></a>

### AcceptDomainTransferFromAnotherAwsAccount Example
<a name="API_domains_AcceptDomainTransferFromAnotherAwsAccount_Example_1"></a>

This example illustrates one usage of AcceptDomainTransferFromAnotherAwsAccount.

#### Sample Request
<a name="API_domains_AcceptDomainTransferFromAnotherAwsAccount_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20200311T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.AcceptDomainTransferFromAnotherAwsAccount
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
    "DomainName":"example.com",
    "Password":"CeT2Zxs~Example"
}
```

#### Sample Response
<a name="API_domains_AcceptDomainTransferFromAnotherAwsAccount_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
    "OperationId":"308c56712-faa4-40fe-94c8-b4230example"
}
```

## See Also
<a name="API_domains_AcceptDomainTransferFromAnotherAwsAccount_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/AcceptDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/AcceptDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/AcceptDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/AcceptDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/AcceptDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/AcceptDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/AcceptDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/AcceptDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/AcceptDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/AcceptDomainTransferFromAnotherAwsAccount) 

# AssociateDelegationSignerToDomain
<a name="API_domains_AssociateDelegationSignerToDomain"></a>

 Creates a delegation signer (DS) record in the registry zone for this domain name.

Note that creating DS record at the registry impacts DNSSEC validation of your DNS records. This action may render your domain name unavailable on the internet if the steps are completed in the wrong order, or with incorrect timing. For more information about DNSSEC signing, see [Configuring DNSSEC signing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-configuring-dnssec.html) in the *Route 53 developer guide*.

## Request Syntax
<a name="API_domains_AssociateDelegationSignerToDomain_RequestSyntax"></a>

```
{
   "DomainName": "string",
   "SigningAttributes": { 
      "Algorithm": number,
      "Flags": number,
      "PublicKey": "string"
   }
}
```

## Request Parameters
<a name="API_domains_AssociateDelegationSignerToDomain_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_AssociateDelegationSignerToDomain_RequestSyntax) **   <a name="Route53Domains-domains_AssociateDelegationSignerToDomain-request-DomainName"></a>
The name of the domain.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [SigningAttributes](#API_domains_AssociateDelegationSignerToDomain_RequestSyntax) **   <a name="Route53Domains-domains_AssociateDelegationSignerToDomain-request-SigningAttributes"></a>
The information about a key, including the algorithm, public key-value, and flags.  
Type: [DnssecSigningAttributes](API_domains_DnssecSigningAttributes.md) object  
Required: Yes

## Response Syntax
<a name="API_domains_AssociateDelegationSignerToDomain_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_AssociateDelegationSignerToDomain_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_AssociateDelegationSignerToDomain_ResponseSyntax) **   <a name="Route53Domains-domains_AssociateDelegationSignerToDomain-response-OperationId"></a>
The identifier for tracking the progress of the request. To query the operation status, use [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html).  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_AssociateDelegationSignerToDomain_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DnssecLimitExceeded **   
 This error is returned if you call `AssociateDelegationSignerToDomain` when the specified domain has reached the maximum number of DS records. You can't add any additional DS records unless you delete an existing one first.   
HTTP Status Code: 400

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## See Also
<a name="API_domains_AssociateDelegationSignerToDomain_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/AssociateDelegationSignerToDomain) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/AssociateDelegationSignerToDomain) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/AssociateDelegationSignerToDomain) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/AssociateDelegationSignerToDomain) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/AssociateDelegationSignerToDomain) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/AssociateDelegationSignerToDomain) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/AssociateDelegationSignerToDomain) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/AssociateDelegationSignerToDomain) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/AssociateDelegationSignerToDomain) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/AssociateDelegationSignerToDomain) 

# CancelDomainTransferToAnotherAwsAccount
<a name="API_domains_CancelDomainTransferToAnotherAwsAccount"></a>

Cancels the transfer of a domain from the current AWS account to another AWS account. You initiate a transfer betweenAWS accounts using [TransferDomainToAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_TransferDomainToAnotherAwsAccount.html). 

**Important**  
You must cancel the transfer before the other AWS account accepts the transfer using [AcceptDomainTransferFromAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_AcceptDomainTransferFromAnotherAwsAccount.html).

Use either [ListOperations](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ListOperations.html) or [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html) to determine whether the operation succeeded. [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html) provides additional information, for example, `Domain Transfer from Aws Account 111122223333 has been cancelled`. 

## Request Syntax
<a name="API_domains_CancelDomainTransferToAnotherAwsAccount_RequestSyntax"></a>

```
{
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_CancelDomainTransferToAnotherAwsAccount_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_CancelDomainTransferToAnotherAwsAccount_RequestSyntax) **   <a name="Route53Domains-domains_CancelDomainTransferToAnotherAwsAccount-request-DomainName"></a>
The name of the domain for which you want to cancel the transfer to another AWS account.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_domains_CancelDomainTransferToAnotherAwsAccount_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_CancelDomainTransferToAnotherAwsAccount_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_CancelDomainTransferToAnotherAwsAccount_ResponseSyntax) **   <a name="Route53Domains-domains_CancelDomainTransferToAnotherAwsAccount-response-OperationId"></a>
The identifier that `TransferDomainToAnotherAwsAccount` returned to track the progress of the request. Because the transfer request was canceled, the value is no longer valid, and you can't use `GetOperationDetail` to query the operation status.  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_CancelDomainTransferToAnotherAwsAccount_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_CancelDomainTransferToAnotherAwsAccount_Examples"></a>

### CancelDomainTransferToAnotherAwsAccount Example
<a name="API_domains_CancelDomainTransferToAnotherAwsAccount_Example_1"></a>

This example illustrates one usage of CancelDomainTransferToAnotherAwsAccount.

#### Sample Request
<a name="API_domains_CancelDomainTransferToAnotherAwsAccount_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20200311T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.CancelDomainTransferToAnotherAwsAccount
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
    "DomainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_CancelDomainTransferToAnotherAwsAccount_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
    "OperationId":"308c56712-faa4-40fe-94c8-b4230example"
}
```

## See Also
<a name="API_domains_CancelDomainTransferToAnotherAwsAccount_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/CancelDomainTransferToAnotherAwsAccount) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/CancelDomainTransferToAnotherAwsAccount) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/CancelDomainTransferToAnotherAwsAccount) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/CancelDomainTransferToAnotherAwsAccount) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/CancelDomainTransferToAnotherAwsAccount) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/CancelDomainTransferToAnotherAwsAccount) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/CancelDomainTransferToAnotherAwsAccount) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/CancelDomainTransferToAnotherAwsAccount) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/CancelDomainTransferToAnotherAwsAccount) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/CancelDomainTransferToAnotherAwsAccount) 

# CheckDomainAvailability
<a name="API_domains_CheckDomainAvailability"></a>

This operation checks the availability of one domain name. Note that if the availability status of a domain is pending, you must submit another request to determine the availability of the domain name.

## Request Syntax
<a name="API_domains_CheckDomainAvailability_RequestSyntax"></a>

```
{
   "DomainName": "string",
   "IdnLangCode": "string"
}
```

## Request Parameters
<a name="API_domains_CheckDomainAvailability_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_CheckDomainAvailability_RequestSyntax) **   <a name="Route53Domains-domains_CheckDomainAvailability-request-DomainName"></a>
The name of the domain that you want to get availability for. The top-level domain (TLD), such as .com, must be a TLD that Route 53 supports. For a list of supported TLDs, see [Domains that You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) in the *Amazon Route 53 Developer Guide*.  
The domain name can contain only the following characters:  
+ Letters a through z. Domain names are not case sensitive.
+ Numbers 0 through 9.
+ Hyphen (-). You can't specify a hyphen at the beginning or end of a label. 
+ Period (.) to separate the labels in the name, such as the `.` in `example.com`.
Internationalized domain names are not supported for some top-level domains. To determine whether the TLD that you want to use supports internationalized domain names, see [Domains that You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html). For more information, see [Formatting Internationalized Domain Names](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.html#domain-name-format-idns).   
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [IdnLangCode](#API_domains_CheckDomainAvailability_RequestSyntax) **   <a name="Route53Domains-domains_CheckDomainAvailability-request-IdnLangCode"></a>
Reserved for future use.  
Type: String  
Pattern: `|[A-Za-z]{2,3}`   
Required: No

## Response Syntax
<a name="API_domains_CheckDomainAvailability_ResponseSyntax"></a>

```
{
   "Availability": "string"
}
```

## Response Elements
<a name="API_domains_CheckDomainAvailability_ResponseElements"></a>

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

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

 ** [Availability](#API_domains_CheckDomainAvailability_ResponseSyntax) **   <a name="Route53Domains-domains_CheckDomainAvailability-response-Availability"></a>
Whether the domain name is available for registering.  
You can register only domains designated as `AVAILABLE`.
Valid values:    
AVAILABLE  
The domain name is available.  
AVAILABLE\$1RESERVED  
The domain name is reserved under specific conditions.  
AVAILABLE\$1PREORDER  
The domain name is available and can be preordered.  
DONT\$1KNOW  
The TLD registry didn't reply with a definitive answer about whether the domain name is available. Route 53 can return this response for a variety of reasons, for example, the registry is performing maintenance. Try again later.  
INVALID\$1NAME\$1FOR\$1TLD  
The TLD isn't valid. For example, it can contain characters that aren't allowed.  
PENDING  
The TLD registry didn't return a response in the expected amount of time. When the response is delayed, it usually takes just a few extra seconds. You can resubmit the request immediately.  
RESERVED  
The domain name has been reserved for another person or organization.  
UNAVAILABLE  
The domain name is not available.  
UNAVAILABLE\$1PREMIUM  
The domain name is not available.  
UNAVAILABLE\$1RESTRICTED  
The domain name is forbidden.
Type: String  
Valid Values: `AVAILABLE | AVAILABLE_RESERVED | AVAILABLE_PREORDER | UNAVAILABLE | UNAVAILABLE_PREMIUM | UNAVAILABLE_RESTRICTED | RESERVED | DONT_KNOW | INVALID_NAME_FOR_TLD | PENDING` 

## Errors
<a name="API_domains_CheckDomainAvailability_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_CheckDomainAvailability_Examples"></a>

### CheckDomainAvailability Example
<a name="API_domains_CheckDomainAvailability_Example_1"></a>

This example illustrates one usage of CheckDomainAvailability.

#### Sample Request
<a name="API_domains_CheckDomainAvailability_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205225Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.CheckDomainAvailability
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
connections:Keep-Alive
{
   "DomainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_CheckDomainAvailability_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "Availability":"AVAILABLE"
}
```

## See Also
<a name="API_domains_CheckDomainAvailability_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/CheckDomainAvailability) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/CheckDomainAvailability) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/CheckDomainAvailability) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/CheckDomainAvailability) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/CheckDomainAvailability) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/CheckDomainAvailability) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/CheckDomainAvailability) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/CheckDomainAvailability) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/CheckDomainAvailability) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/CheckDomainAvailability) 

# CheckDomainTransferability
<a name="API_domains_CheckDomainTransferability"></a>

Checks whether a domain name can be transferred to Amazon Route 53. 

## Request Syntax
<a name="API_domains_CheckDomainTransferability_RequestSyntax"></a>

```
{
   "AuthCode": "string",
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_CheckDomainTransferability_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [AuthCode](#API_domains_CheckDomainTransferability_RequestSyntax) **   <a name="Route53Domains-domains_CheckDomainTransferability-request-AuthCode"></a>
If the registrar for the top-level domain (TLD) requires an authorization code to transfer the domain, the code that you got from the current registrar for the domain.  
Type: String  
Length Constraints: Maximum length of 1024.  
Required: No

 ** [DomainName](#API_domains_CheckDomainTransferability_RequestSyntax) **   <a name="Route53Domains-domains_CheckDomainTransferability-request-DomainName"></a>
The name of the domain that you want to transfer to Route 53. The top-level domain (TLD), such as .com, must be a TLD that Route 53 supports. For a list of supported TLDs, see [Domains that You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) in the *Amazon Route 53 Developer Guide*.  
The domain name can contain only the following characters:  
+ Letters a through z. Domain names are not case sensitive.
+ Numbers 0 through 9.
+ Hyphen (-). You can't specify a hyphen at the beginning or end of a label. 
+ Period (.) to separate the labels in the name, such as the `.` in `example.com`.
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_domains_CheckDomainTransferability_ResponseSyntax"></a>

```
{
   "Message": "string",
   "Transferability": { 
      "Transferable": "string"
   }
}
```

## Response Elements
<a name="API_domains_CheckDomainTransferability_ResponseElements"></a>

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

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

 ** [Message](#API_domains_CheckDomainTransferability_ResponseSyntax) **   <a name="Route53Domains-domains_CheckDomainTransferability-response-Message"></a>
Provides an explanation for when a domain can't be transferred.  
Type: String

 ** [Transferability](#API_domains_CheckDomainTransferability_ResponseSyntax) **   <a name="Route53Domains-domains_CheckDomainTransferability-response-Transferability"></a>
A complex type that contains information about whether the specified domain can be transferred to Route 53.  
Type: [DomainTransferability](API_domains_DomainTransferability.md) object

## Errors
<a name="API_domains_CheckDomainTransferability_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_CheckDomainTransferability_Examples"></a>

### CheckDomainTransferability Example
<a name="API_domains_CheckDomainTransferability_Example_1"></a>

This example illustrates one usage of CheckDomainTransferability.

#### Sample Request
<a name="API_domains_CheckDomainTransferability_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205225Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.CheckDomainTransferability
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
connections:Keep-Alive
{
   "DomainName": "example.com",
   "AuthCode": "T92XJ38"
}
```

#### Sample Response
<a name="API_domains_CheckDomainTransferability_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "Transferability":
      {"Transferable":"TRANSFERABLE"}
}
```

## See Also
<a name="API_domains_CheckDomainTransferability_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/CheckDomainTransferability) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/CheckDomainTransferability) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/CheckDomainTransferability) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/CheckDomainTransferability) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/CheckDomainTransferability) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/CheckDomainTransferability) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/CheckDomainTransferability) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/CheckDomainTransferability) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/CheckDomainTransferability) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/CheckDomainTransferability) 

# DeleteDomain
<a name="API_domains_DeleteDomain"></a>

This operation deletes the specified domain. This action is permanent. For more information, see [Deleting a domain name registration](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-delete.html).

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.

1. 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). 

1. When the registration has been deleted, we'll send you a confirmation to the registrant contact. The email will come from `noreply@domainnameverification.net` or `noreply@emailverification.info` or `noreply@registrar.amazon`.

## Request Syntax
<a name="API_domains_DeleteDomain_RequestSyntax"></a>

```
{
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_DeleteDomain_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_DeleteDomain_RequestSyntax) **   <a name="Route53Domains-domains_DeleteDomain-request-DomainName"></a>
Name of the domain to be deleted.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_domains_DeleteDomain_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_DeleteDomain_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_DeleteDomain_ResponseSyntax) **   <a name="Route53Domains-domains_DeleteDomain-response-OperationId"></a>
Identifier for tracking the progress of the request. To query the operation status, use [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html).  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_DeleteDomain_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## See Also
<a name="API_domains_DeleteDomain_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/DeleteDomain) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/DeleteDomain) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/DeleteDomain) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/DeleteDomain) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/DeleteDomain) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/DeleteDomain) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/DeleteDomain) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/DeleteDomain) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/DeleteDomain) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/DeleteDomain) 

# DeleteTagsForDomain
<a name="API_domains_DeleteTagsForDomain"></a>

This operation deletes the specified tags for a domain.

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

## Request Syntax
<a name="API_domains_DeleteTagsForDomain_RequestSyntax"></a>

```
{
   "DomainName": "string",
   "TagsToDelete": [ "string" ]
}
```

## Request Parameters
<a name="API_domains_DeleteTagsForDomain_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_DeleteTagsForDomain_RequestSyntax) **   <a name="Route53Domains-domains_DeleteTagsForDomain-request-DomainName"></a>
The domain for which you want to delete one or more tags.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [TagsToDelete](#API_domains_DeleteTagsForDomain_RequestSyntax) **   <a name="Route53Domains-domains_DeleteTagsForDomain-request-TagsToDelete"></a>
A list of tag keys to delete.  
Type: Array of strings  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Required: Yes

## Response Elements
<a name="API_domains_DeleteTagsForDomain_ResponseElements"></a>

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

## Errors
<a name="API_domains_DeleteTagsForDomain_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_DeleteTagsForDomain_Examples"></a>

### DeleteTagsForDomain Example
<a name="API_domains_DeleteTagsForDomain_Example_1"></a>

This example illustrates one usage of DeleteTagsForDomain.

#### Sample Request
<a name="API_domains_DeleteTagsForDomain_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.DeleteTagsForDomain
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName": "example.com",
   "TagsToDelete": [
      "foo",
      "foo2"
   ]
}
```

#### Sample Response
<a name="API_domains_DeleteTagsForDomain_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{}
```

## See Also
<a name="API_domains_DeleteTagsForDomain_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/DeleteTagsForDomain) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/DeleteTagsForDomain) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/DeleteTagsForDomain) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/DeleteTagsForDomain) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/DeleteTagsForDomain) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/DeleteTagsForDomain) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/DeleteTagsForDomain) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/DeleteTagsForDomain) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/DeleteTagsForDomain) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/DeleteTagsForDomain) 

# DisableDomainAutoRenew
<a name="API_domains_DisableDomainAutoRenew"></a>

This operation disables automatic renewal of domain registration for the specified domain.

## Request Syntax
<a name="API_domains_DisableDomainAutoRenew_RequestSyntax"></a>

```
{
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_DisableDomainAutoRenew_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_DisableDomainAutoRenew_RequestSyntax) **   <a name="Route53Domains-domains_DisableDomainAutoRenew-request-DomainName"></a>
The name of the domain that you want to disable automatic renewal for.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Elements
<a name="API_domains_DisableDomainAutoRenew_ResponseElements"></a>

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

## Errors
<a name="API_domains_DisableDomainAutoRenew_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_DisableDomainAutoRenew_Examples"></a>

### DisableDomainAutoRenew Example
<a name="API_domains_DisableDomainAutoRenew_Example_1"></a>

This example illustrates one usage of DisableDomainAutoRenew.

#### Sample Request
<a name="API_domains_DisableDomainAutoRenew_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.DisableDomainAutoRenew
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_DisableDomainAutoRenew_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]{}
```

## See Also
<a name="API_domains_DisableDomainAutoRenew_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/DisableDomainAutoRenew) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/DisableDomainAutoRenew) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/DisableDomainAutoRenew) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/DisableDomainAutoRenew) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/DisableDomainAutoRenew) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/DisableDomainAutoRenew) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/DisableDomainAutoRenew) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/DisableDomainAutoRenew) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/DisableDomainAutoRenew) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/DisableDomainAutoRenew) 

# DisableDomainTransferLock
<a name="API_domains_DisableDomainTransferLock"></a>

This operation removes the transfer lock on the domain (specifically the `clientTransferProhibited` status) to allow domain transfers. We recommend you refrain from performing this action unless you intend to transfer the domain to a different registrar. Successful submission returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

## Request Syntax
<a name="API_domains_DisableDomainTransferLock_RequestSyntax"></a>

```
{
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_DisableDomainTransferLock_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_DisableDomainTransferLock_RequestSyntax) **   <a name="Route53Domains-domains_DisableDomainTransferLock-request-DomainName"></a>
The name of the domain that you want to remove the transfer lock for.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_domains_DisableDomainTransferLock_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_DisableDomainTransferLock_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_DisableDomainTransferLock_ResponseSyntax) **   <a name="Route53Domains-domains_DisableDomainTransferLock-response-OperationId"></a>
Identifier for tracking the progress of the request. To query the operation status, use [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html).  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_DisableDomainTransferLock_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_DisableDomainTransferLock_Examples"></a>

### DisableDomainTransferLock Example
<a name="API_domains_DisableDomainTransferLock_Example_1"></a>

This example illustrates one usage of DisableDomainTransferLock.

#### Sample Request
<a name="API_domains_DisableDomainTransferLock_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.DisableDomainTransferLock
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
"DomainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_DisableDomainTransferLock_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
"OperationId":"0b370c79-faa4-40fe-94c8-b423069de3f6"
}
```

## See Also
<a name="API_domains_DisableDomainTransferLock_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/DisableDomainTransferLock) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/DisableDomainTransferLock) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/DisableDomainTransferLock) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/DisableDomainTransferLock) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/DisableDomainTransferLock) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/DisableDomainTransferLock) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/DisableDomainTransferLock) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/DisableDomainTransferLock) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/DisableDomainTransferLock) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/DisableDomainTransferLock) 

# DisassociateDelegationSignerFromDomain
<a name="API_domains_DisassociateDelegationSignerFromDomain"></a>

Deletes a delegation signer (DS) record in the registry zone for this domain name.

## Request Syntax
<a name="API_domains_DisassociateDelegationSignerFromDomain_RequestSyntax"></a>

```
{
   "DomainName": "string",
   "Id": "string"
}
```

## Request Parameters
<a name="API_domains_DisassociateDelegationSignerFromDomain_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_DisassociateDelegationSignerFromDomain_RequestSyntax) **   <a name="Route53Domains-domains_DisassociateDelegationSignerFromDomain-request-DomainName"></a>
Name of the domain.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [Id](#API_domains_DisassociateDelegationSignerFromDomain_RequestSyntax) **   <a name="Route53Domains-domains_DisassociateDelegationSignerFromDomain-request-Id"></a>
An internal identification number assigned to each DS record after it’s created. You can retrieve it as part of DNSSEC information returned by [GetDomainDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetDomainDetail.html).  
Type: String  
Required: Yes

## Response Syntax
<a name="API_domains_DisassociateDelegationSignerFromDomain_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_DisassociateDelegationSignerFromDomain_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_DisassociateDelegationSignerFromDomain_ResponseSyntax) **   <a name="Route53Domains-domains_DisassociateDelegationSignerFromDomain-response-OperationId"></a>
Identifier for tracking the progress of the request. To query the operation status, use [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html).  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_DisassociateDelegationSignerFromDomain_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## See Also
<a name="API_domains_DisassociateDelegationSignerFromDomain_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/DisassociateDelegationSignerFromDomain) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/DisassociateDelegationSignerFromDomain) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/DisassociateDelegationSignerFromDomain) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/DisassociateDelegationSignerFromDomain) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/DisassociateDelegationSignerFromDomain) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/DisassociateDelegationSignerFromDomain) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/DisassociateDelegationSignerFromDomain) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/DisassociateDelegationSignerFromDomain) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/DisassociateDelegationSignerFromDomain) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/DisassociateDelegationSignerFromDomain) 

# EnableDomainAutoRenew
<a name="API_domains_EnableDomainAutoRenew"></a>

This operation configures Amazon Route 53 to automatically renew the specified domain before the domain registration expires. The cost of renewing your domain registration is billed to your AWS account.

The period during which you can renew a domain name varies by TLD. For a list of TLDs and their renewal policies, see [Domains That You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) in the *Amazon Route 53 Developer Guide*. Route 53 requires that you renew before the end of the renewal period so we can complete processing before the deadline.

## Request Syntax
<a name="API_domains_EnableDomainAutoRenew_RequestSyntax"></a>

```
{
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_EnableDomainAutoRenew_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_EnableDomainAutoRenew_RequestSyntax) **   <a name="Route53Domains-domains_EnableDomainAutoRenew-request-DomainName"></a>
The name of the domain that you want to enable automatic renewal for.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Elements
<a name="API_domains_EnableDomainAutoRenew_ResponseElements"></a>

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

## Errors
<a name="API_domains_EnableDomainAutoRenew_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_EnableDomainAutoRenew_Examples"></a>

### EnableDomainAutoRenew Example
<a name="API_domains_EnableDomainAutoRenew_Example_1"></a>

This example illustrates one usage of EnableDomainAutoRenew.

#### Sample Request
<a name="API_domains_EnableDomainAutoRenew_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.EnableDomainAutoRenew
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_EnableDomainAutoRenew_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]{}
```

## See Also
<a name="API_domains_EnableDomainAutoRenew_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/EnableDomainAutoRenew) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/EnableDomainAutoRenew) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/EnableDomainAutoRenew) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/EnableDomainAutoRenew) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/EnableDomainAutoRenew) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/EnableDomainAutoRenew) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/EnableDomainAutoRenew) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/EnableDomainAutoRenew) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/EnableDomainAutoRenew) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/EnableDomainAutoRenew) 

# EnableDomainTransferLock
<a name="API_domains_EnableDomainTransferLock"></a>

This operation sets the transfer lock on the domain (specifically the `clientTransferProhibited` status) to prevent domain transfers. Successful submission returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

## Request Syntax
<a name="API_domains_EnableDomainTransferLock_RequestSyntax"></a>

```
{
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_EnableDomainTransferLock_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_EnableDomainTransferLock_RequestSyntax) **   <a name="Route53Domains-domains_EnableDomainTransferLock-request-DomainName"></a>
The name of the domain that you want to set the transfer lock for.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_domains_EnableDomainTransferLock_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_EnableDomainTransferLock_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_EnableDomainTransferLock_ResponseSyntax) **   <a name="Route53Domains-domains_EnableDomainTransferLock-response-OperationId"></a>
Identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_EnableDomainTransferLock_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_EnableDomainTransferLock_Examples"></a>

### EnableDomainTransferLock Example
<a name="API_domains_EnableDomainTransferLock_Example_1"></a>

This example illustrates one usage of EnableDomainTransferLock.

#### Sample Request
<a name="API_domains_EnableDomainTransferLock_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.EnableDomainTransferLock
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_EnableDomainTransferLock_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "OperationId":"0b370c79-faa4-40fe-94c8-b423069de3f6"
}
```

## See Also
<a name="API_domains_EnableDomainTransferLock_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/EnableDomainTransferLock) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/EnableDomainTransferLock) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/EnableDomainTransferLock) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/EnableDomainTransferLock) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/EnableDomainTransferLock) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/EnableDomainTransferLock) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/EnableDomainTransferLock) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/EnableDomainTransferLock) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/EnableDomainTransferLock) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/EnableDomainTransferLock) 

# GetContactReachabilityStatus
<a name="API_domains_GetContactReachabilityStatus"></a>

For operations that require confirmation that the email address for the registrant contact is valid, such as registering a new domain, this operation returns information about whether the registrant contact has responded.

If you want us to resend the email, use the `ResendContactReachabilityEmail` operation.

## Request Syntax
<a name="API_domains_GetContactReachabilityStatus_RequestSyntax"></a>

```
{
   "domainName": "string"
}
```

## Request Parameters
<a name="API_domains_GetContactReachabilityStatus_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [domainName](#API_domains_GetContactReachabilityStatus_RequestSyntax) **   <a name="Route53Domains-domains_GetContactReachabilityStatus-request-domainName"></a>
The name of the domain for which you want to know whether the registrant contact has confirmed that the email address is valid.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: No

## Response Syntax
<a name="API_domains_GetContactReachabilityStatus_ResponseSyntax"></a>

```
{
   "domainName": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_domains_GetContactReachabilityStatus_ResponseElements"></a>

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

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

 ** [domainName](#API_domains_GetContactReachabilityStatus_ResponseSyntax) **   <a name="Route53Domains-domains_GetContactReachabilityStatus-response-domainName"></a>
The domain name for which you requested the reachability status.  
Type: String  
Length Constraints: Maximum length of 255.

 ** [status](#API_domains_GetContactReachabilityStatus_ResponseSyntax) **   <a name="Route53Domains-domains_GetContactReachabilityStatus-response-status"></a>
Whether the registrant contact has responded. Values include the following:    
PENDING  
We sent the confirmation email and haven't received a response yet.  
DONE  
We sent the email and got confirmation from the registrant contact.  
EXPIRED  
The time limit expired before the registrant contact responded.
Type: String  
Valid Values: `PENDING | DONE | EXPIRED` 

## Errors
<a name="API_domains_GetContactReachabilityStatus_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_GetContactReachabilityStatus_Examples"></a>

### GetContactReachabilityStatus Example
<a name="API_domains_GetContactReachabilityStatus_Example_1"></a>

This example illustrates one usage of GetContactReachabilityStatus.

#### Sample Request
<a name="API_domains_GetContactReachabilityStatus_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205225Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.GetContactReachabilityStatus
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
connections:Keep-Alive
{
   "domainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_GetContactReachabilityStatus_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "domainName":"example.com",
   "status":"PENDING"
}
```

## See Also
<a name="API_domains_GetContactReachabilityStatus_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/GetContactReachabilityStatus) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/GetContactReachabilityStatus) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/GetContactReachabilityStatus) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/GetContactReachabilityStatus) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetContactReachabilityStatus) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/GetContactReachabilityStatus) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/GetContactReachabilityStatus) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/GetContactReachabilityStatus) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/GetContactReachabilityStatus) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/GetContactReachabilityStatus) 

# GetDomainDetail
<a name="API_domains_GetDomainDetail"></a>

This operation returns detailed information about a specified domain that is associated with the current AWS account. Contact information for the domain is also returned as part of the output.

## Request Syntax
<a name="API_domains_GetDomainDetail_RequestSyntax"></a>

```
{
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_GetDomainDetail_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_GetDomainDetail_RequestSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-request-DomainName"></a>
The name of the domain that you want to get detailed information about.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_domains_GetDomainDetail_ResponseSyntax"></a>

```
{
   "AbuseContactEmail": "string",
   "AbuseContactPhone": "string",
   "AdminContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "AdminPrivacy": boolean,
   "AutoRenew": boolean,
   "BillingContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "BillingPrivacy": boolean,
   "CreationDate": number,
   "DnsSec": "string",
   "DnssecKeys": [ 
      { 
         "Algorithm": number,
         "Digest": "string",
         "DigestType": number,
         "Flags": number,
         "Id": "string",
         "KeyTag": number,
         "PublicKey": "string"
      }
   ],
   "DomainName": "string",
   "ExpirationDate": number,
   "Nameservers": [ 
      { 
         "GlueIps": [ "string" ],
         "Name": "string"
      }
   ],
   "RegistrantContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "RegistrantPrivacy": boolean,
   "RegistrarName": "string",
   "RegistrarUrl": "string",
   "RegistryDomainId": "string",
   "Reseller": "string",
   "StatusList": [ "string" ],
   "TechContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "TechPrivacy": boolean,
   "UpdatedDate": number,
   "WhoIsServer": "string"
}
```

## Response Elements
<a name="API_domains_GetDomainDetail_ResponseElements"></a>

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

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

 ** [AbuseContactEmail](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-AbuseContactEmail"></a>
Email address to contact to report incorrect contact information for a domain, to report that the domain is being used to send spam, to report that someone is cybersquatting on a domain name, or report some other type of abuse.  
Type: String  
Length Constraints: Maximum length of 254.

 ** [AbuseContactPhone](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-AbuseContactPhone"></a>
Phone number for reporting abuse.  
Type: String  
Length Constraints: Maximum length of 30.

 ** [AdminContact](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-AdminContact"></a>
Provides details about the domain administrative contact.  
Type: [ContactDetail](API_domains_ContactDetail.md) object

 ** [AdminPrivacy](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-AdminPrivacy"></a>
Specifies whether contact information is concealed from WHOIS queries. If the value is `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If the value is `false`, WHOIS queries return the information that you entered for the admin contact.  
Type: Boolean

 ** [AutoRenew](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-AutoRenew"></a>
Specifies whether the domain registration is set to renew automatically.  
Type: Boolean

 ** [BillingContact](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-BillingContact"></a>
Provides details about the domain billing contact.  
Type: [ContactDetail](API_domains_ContactDetail.md) object

 ** [BillingPrivacy](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-BillingPrivacy"></a>
Specifies whether contact information is concealed from WHOIS queries. If the value is `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If the value is `false`, WHOIS queries return the information that you entered for the billing contact.  
Type: Boolean

 ** [CreationDate](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-CreationDate"></a>
The date when the domain was created as found in the response to a WHOIS query. The date and time is in Unix time format and Coordinated Universal time (UTC).  
Type: Timestamp

 ** [DnsSec](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-DnsSec"></a>
Deprecated.  
Type: String

 ** [DnssecKeys](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-DnssecKeys"></a>
A complex type that contains information about the DNSSEC configuration.  
Type: Array of [DnssecKey](API_domains_DnssecKey.md) objects

 ** [DomainName](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-DomainName"></a>
The name of a domain.  
Type: String  
Length Constraints: Maximum length of 255.

 ** [ExpirationDate](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-ExpirationDate"></a>
The date when the registration for the domain is set to expire. The date and time is in Unix time format and Coordinated Universal time (UTC).  
Type: Timestamp

 ** [Nameservers](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-Nameservers"></a>
The name servers of the domain.  
Type: Array of [Nameserver](API_domains_Nameserver.md) objects

 ** [RegistrantContact](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-RegistrantContact"></a>
Provides details about the domain registrant.  
Type: [ContactDetail](API_domains_ContactDetail.md) object

 ** [RegistrantPrivacy](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-RegistrantPrivacy"></a>
Specifies whether contact information is concealed from WHOIS queries. If the value is `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If the value is `false`, WHOIS queries return the information that you entered for the registrant contact (domain owner).  
Type: Boolean

 ** [RegistrarName](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-RegistrarName"></a>
Name of the registrar of the domain as identified in the registry.   
Type: String

 ** [RegistrarUrl](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-RegistrarUrl"></a>
Web address of the registrar.  
Type: String

 ** [RegistryDomainId](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-RegistryDomainId"></a>
Reserved for future use.  
Type: String

 ** [Reseller](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-Reseller"></a>
Reserved for future use.  
Type: String

 ** [StatusList](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-StatusList"></a>
An array of domain name status codes, also known as Extensible Provisioning Protocol (EPP) status codes.  
ICANN, the organization that maintains a central database of domain names, has developed a set of domain name status codes that tell you the status of a variety of operations on a domain name, for example, registering a domain name, transferring a domain name to another registrar, renewing the registration for a domain name, and so on. All registrars use this same set of status codes.  
For a current list of domain name status codes and an explanation of what each code means, go to the [ICANN website](https://www.icann.org/) and search for `epp status codes`. (Search on the ICANN website; web searches sometimes return an old version of the document.)  
Type: Array of strings

 ** [TechContact](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-TechContact"></a>
Provides details about the domain technical contact.  
Type: [ContactDetail](API_domains_ContactDetail.md) object

 ** [TechPrivacy](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-TechPrivacy"></a>
Specifies whether contact information is concealed from WHOIS queries. If the value is `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If the value is `false`, WHOIS queries return the information that you entered for the technical contact.  
Type: Boolean

 ** [UpdatedDate](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-UpdatedDate"></a>
The last updated date of the domain as found in the response to a WHOIS query. The date and time is in Unix time format and Coordinated Universal time (UTC).  
Type: Timestamp

 ** [WhoIsServer](#API_domains_GetDomainDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainDetail-response-WhoIsServer"></a>
The fully qualified name of the WHOIS server that can answer the WHOIS query for the domain.  
Type: String

## Errors
<a name="API_domains_GetDomainDetail_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_GetDomainDetail_Examples"></a>

### GetDomainDetail Example
<a name="API_domains_GetDomainDetail_Example_1"></a>

This example illustrates one usage of GetDomainDetail.

#### Sample Request
<a name="API_domains_GetDomainDetail_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.GetDomainDetail
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_GetDomainDetail_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "AbuseContactEmail":"abuse@support.gandi.net",
   "AbuseContactPhone":"+33.170377661",
   "AdminContact":{
      "AddressLine1":"1 Any Street",
      "AddressLine2":"",
      "City":"Anytown",
      "CountryCode":"US",
      "Email":"john@example.com",
      "ExtraParams":[
      ],
      "FirstName":"John",
      "LastName":"Doe",
      "PhoneNumber":"+1.1234567890",
      "State":"WA",
      "ZipCode":"98101"
   },
   "AdminPrivacy":true,
   "AutoRenew":true,
   "CreationDate":1400010459,
   "DomainName":"example.com",
   "ExpirationDate":1431539259,
   "Nameservers":[
      {
         "GlueIps":[
         ],
         "Name":"ns-2048.awsdns-64.com"
      },
      {
         "GlueIps":[
         ],
         "Name":"ns-2051.awsdns-67.co.uk"
      },
      {
         "GlueIps":[
         ],
         "Name":"ns-2050.awsdns-66.org"
      },
      {
         "GlueIps":[
         ],
         "Name":"ns-2049.awsdns-65.net"
      }
   ],
   "RegistrantContact":{
      "AddressLine1":"1 Any Street",
      "AddressLine2":"",
      "City":"Anytown",
      "CountryCode":"US",
      "Email":"john@example.com",
      "ExtraParams":[
      ],
      "FirstName":"John",
      "LastName":"Doe",
      "PhoneNumber":"+1.1234567890",
      "State":"WA",
      "ZipCode":"98101"
   },
   "RegistrantPrivacy":true,
   "RegistrarName":"GANDI SAS",
   "RegistrarUrl":"http://www.gandi.net",
   "StatusList":[
   "clientTransferProhibited"
   ],
   "TechContact":{
      "AddressLine1":"1 Any Street",
      "AddressLine2":"",
      "City":"Anytown",
      "CountryCode":"US",
      "Email":"john@example.com",
      "ExtraParams":[
      ],
      "FirstName":"John",
      "LastName":"Doe",
      "PhoneNumber":"+1.1234567890",
      "State":"WA",
      "ZipCode":"98101"
      },
   "TechPrivacy":true,
   "UpdatedDate":1400010459,
   "WhoIsServer":"whois.gandi.net"
}
```

## See Also
<a name="API_domains_GetDomainDetail_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/GetDomainDetail) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/GetDomainDetail) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/GetDomainDetail) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/GetDomainDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetDomainDetail) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/GetDomainDetail) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/GetDomainDetail) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/GetDomainDetail) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/GetDomainDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/GetDomainDetail) 

# GetDomainSuggestions
<a name="API_domains_GetDomainSuggestions"></a>

The GetDomainSuggestions operation returns a list of suggested domain names.

## Request Syntax
<a name="API_domains_GetDomainSuggestions_RequestSyntax"></a>

```
{
   "DomainName": "string",
   "OnlyAvailable": boolean,
   "SuggestionCount": number
}
```

## Request Parameters
<a name="API_domains_GetDomainSuggestions_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_GetDomainSuggestions_RequestSyntax) **   <a name="Route53Domains-domains_GetDomainSuggestions-request-DomainName"></a>
A domain name that you want to use as the basis for a list of possible domain names. The top-level domain (TLD), such as .com, must be a TLD that Route 53 supports. For a list of supported TLDs, see [Domains that You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) in the *Amazon Route 53 Developer Guide*.  
The domain name can contain only the following characters:  
+ Letters a through z. Domain names are not case sensitive.
+ Numbers 0 through 9.
+ Hyphen (-). You can't specify a hyphen at the beginning or end of a label. 
+ Period (.) to separate the labels in the name, such as the `.` in `example.com`.
Internationalized domain names are not supported for some top-level domains. To determine whether the TLD that you want to use supports internationalized domain names, see [Domains that You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html).   
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [OnlyAvailable](#API_domains_GetDomainSuggestions_RequestSyntax) **   <a name="Route53Domains-domains_GetDomainSuggestions-request-OnlyAvailable"></a>
If `OnlyAvailable` is `true`, Route 53 returns only domain names that are available. If `OnlyAvailable` is `false`, Route 53 returns domain names without checking whether they're available to be registered. To determine whether the domain is available, you can call `checkDomainAvailability` for each suggestion.  
Type: Boolean  
Required: Yes

 ** [SuggestionCount](#API_domains_GetDomainSuggestions_RequestSyntax) **   <a name="Route53Domains-domains_GetDomainSuggestions-request-SuggestionCount"></a>
The number of suggested domain names that you want Route 53 to return. Specify a value between 1 and 50. Note that fewer than the requested number might be returned.  
Type: Integer  
Required: Yes

## Response Syntax
<a name="API_domains_GetDomainSuggestions_ResponseSyntax"></a>

```
{
   "SuggestionsList": [ 
      { 
         "Availability": "string",
         "DomainName": "string"
      }
   ]
}
```

## Response Elements
<a name="API_domains_GetDomainSuggestions_ResponseElements"></a>

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

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

 ** [SuggestionsList](#API_domains_GetDomainSuggestions_ResponseSyntax) **   <a name="Route53Domains-domains_GetDomainSuggestions-response-SuggestionsList"></a>
A list of possible domain names. If you specified `true` for `OnlyAvailable` in the request, the list contains only domains that are available for registration.  
Type: Array of [DomainSuggestion](API_domains_DomainSuggestion.md) objects

## Errors
<a name="API_domains_GetDomainSuggestions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_GetDomainSuggestions_Examples"></a>

### GetDomainSuggestions Example
<a name="API_domains_GetDomainSuggestions_Example_1"></a>

This example illustrates one usage of GetDomainSuggestions.

#### Sample Request
<a name="API_domains_GetDomainSuggestions_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.GetDomainSuggestions
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
    "DomainName": "example.com",
    "SuggestionCount": 8,
    "OnlyAvailable": false
}
```

#### Sample Response
<a name="API_domains_GetDomainSuggestions_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
    "SuggestionsList":[
        {"DomainName": "example.net"},
        {"DomainName": "example.org"},
        {"DomainName": "example.io"},
        {"DomainName": "example.com.au"},
        {"DomainName": "example.co.uk"},
        {"DomainName": "example.de"},
        {"DomainName": "example.co"},
        {"DomainName": "example.info"}
    ]
}
```

## See Also
<a name="API_domains_GetDomainSuggestions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/GetDomainSuggestions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/GetDomainSuggestions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/GetDomainSuggestions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/GetDomainSuggestions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetDomainSuggestions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/GetDomainSuggestions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/GetDomainSuggestions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/GetDomainSuggestions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/GetDomainSuggestions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/GetDomainSuggestions) 

# GetOperationDetail
<a name="API_domains_GetOperationDetail"></a>

This operation returns the current status of an operation that is not completed.

## Request Syntax
<a name="API_domains_GetOperationDetail_RequestSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Request Parameters
<a name="API_domains_GetOperationDetail_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [OperationId](#API_domains_GetOperationDetail_RequestSyntax) **   <a name="Route53Domains-domains_GetOperationDetail-request-OperationId"></a>
The identifier for the operation for which you want to get the status. Route 53 returned the identifier in the response to the original request.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_domains_GetOperationDetail_ResponseSyntax"></a>

```
{
   "DomainName": "string",
   "LastUpdatedDate": number,
   "Message": "string",
   "OperationId": "string",
   "Status": "string",
   "StatusFlag": "string",
   "SubmittedDate": number,
   "Type": "string"
}
```

## Response Elements
<a name="API_domains_GetOperationDetail_ResponseElements"></a>

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

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

 ** [DomainName](#API_domains_GetOperationDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetOperationDetail-response-DomainName"></a>
The name of a domain.  
Type: String  
Length Constraints: Maximum length of 255.

 ** [LastUpdatedDate](#API_domains_GetOperationDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetOperationDetail-response-LastUpdatedDate"></a>
 The date when the operation was last updated.   
Type: Timestamp

 ** [Message](#API_domains_GetOperationDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetOperationDetail-response-Message"></a>
Detailed information on the status including possible errors.  
Type: String

 ** [OperationId](#API_domains_GetOperationDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetOperationDetail-response-OperationId"></a>
The identifier for the operation.  
Type: String  
Length Constraints: Maximum length of 255.

 ** [Status](#API_domains_GetOperationDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetOperationDetail-response-Status"></a>
The current status of the requested operation in the system.  
Type: String  
Valid Values: `SUBMITTED | IN_PROGRESS | ERROR | SUCCESSFUL | FAILED` 

 ** [StatusFlag](#API_domains_GetOperationDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetOperationDetail-response-StatusFlag"></a>
 Lists any outstanding operations that require customer action. Valid values are:  
+  `PENDING_ACCEPTANCE`: The operation is waiting for acceptance from the account that is receiving the domain.
+  `PENDING_CUSTOMER_ACTION`: The operation is waiting for customer action, for example, returning an email.
+  `PENDING_AUTHORIZATION`: The operation is waiting for the form of authorization. For more information, see [ResendOperationAuthorization](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ResendOperationAuthorization.html).
+  `PENDING_PAYMENT_VERIFICATION`: The operation is waiting for the payment method to validate.
+  `PENDING_SUPPORT_CASE`: The operation includes a support case and is waiting for its resolution.
Type: String  
Valid Values: `PENDING_ACCEPTANCE | PENDING_CUSTOMER_ACTION | PENDING_AUTHORIZATION | PENDING_PAYMENT_VERIFICATION | PENDING_SUPPORT_CASE` 

 ** [SubmittedDate](#API_domains_GetOperationDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetOperationDetail-response-SubmittedDate"></a>
The date when the request was submitted.  
Type: Timestamp

 ** [Type](#API_domains_GetOperationDetail_ResponseSyntax) **   <a name="Route53Domains-domains_GetOperationDetail-response-Type"></a>
The type of operation that was requested.  
Type: String  
Valid Values: `REGISTER_DOMAIN | DELETE_DOMAIN | TRANSFER_IN_DOMAIN | UPDATE_DOMAIN_CONTACT | UPDATE_NAMESERVER | CHANGE_PRIVACY_PROTECTION | DOMAIN_LOCK | ENABLE_AUTORENEW | DISABLE_AUTORENEW | ADD_DNSSEC | REMOVE_DNSSEC | EXPIRE_DOMAIN | TRANSFER_OUT_DOMAIN | CHANGE_DOMAIN_OWNER | RENEW_DOMAIN | PUSH_DOMAIN | INTERNAL_TRANSFER_OUT_DOMAIN | INTERNAL_TRANSFER_IN_DOMAIN | RELEASE_TO_GANDI | TRANSFER_ON_RENEW | RESTORE_DOMAIN` 

## Errors
<a name="API_domains_GetOperationDetail_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

## Examples
<a name="API_domains_GetOperationDetail_Examples"></a>

### GetOperationDetail Example
<a name="API_domains_GetOperationDetail_Example_1"></a>

This example illustrates one usage of GetOperationDetail.

#### Sample Request
<a name="API_domains_GetOperationDetail_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.GetOperationDetail
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "OperationId":"43884ce5-e30a-4801-858f-7aa86356c127"
}
```

#### Sample Response
<a name="API_domains_GetOperationDetail_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "DomainName":"happierdomain.ca",
   "OperationId":"43884ce5-e30a-4801-858f-7aa86356c127",
   "Status":"WORKFLOW_IN_PROGRESS",
   "SubmittedDate" : 1402630939.057,
   "Type" : "REGISTER_DOMAIN"
}
```

## See Also
<a name="API_domains_GetOperationDetail_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/GetOperationDetail) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/GetOperationDetail) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/GetOperationDetail) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/GetOperationDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetOperationDetail) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/GetOperationDetail) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/GetOperationDetail) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/GetOperationDetail) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/GetOperationDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/GetOperationDetail) 

# ListDomains
<a name="API_domains_ListDomains"></a>

This operation returns all the domain names registered with Amazon Route 53 for the current AWS account if no filtering conditions are used.

## Request Syntax
<a name="API_domains_ListDomains_RequestSyntax"></a>

```
{
   "FilterConditions": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Values": [ "string" ]
      }
   ],
   "Marker": "string",
   "MaxItems": number,
   "SortCondition": { 
      "Name": "string",
      "SortOrder": "string"
   }
}
```

## Request Parameters
<a name="API_domains_ListDomains_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [FilterConditions](#API_domains_ListDomains_RequestSyntax) **   <a name="Route53Domains-domains_ListDomains-request-FilterConditions"></a>
A complex type that contains information about the filters applied during the `ListDomains` request. The filter conditions can include domain name and domain expiration.  
Type: Array of [FilterCondition](API_domains_FilterCondition.md) objects  
Required: No

 ** [Marker](#API_domains_ListDomains_RequestSyntax) **   <a name="Route53Domains-domains_ListDomains-request-Marker"></a>
For an initial request for a list of domains, omit this element. If the number of domains that are associated with the current AWS account is greater than the value that you specified for `MaxItems`, you can use `Marker` to return additional domains. Get the value of `NextPageMarker` from the previous response, and submit another request that includes the value of `NextPageMarker` in the `Marker` element.  
Constraints: The marker must match the value specified in the previous request.  
Type: String  
Length Constraints: Maximum length of 4096.  
Required: No

 ** [MaxItems](#API_domains_ListDomains_RequestSyntax) **   <a name="Route53Domains-domains_ListDomains-request-MaxItems"></a>
Number of domains to be returned.  
Default: 20  
Type: Integer  
Valid Range: Maximum value of 100.  
Required: No

 ** [SortCondition](#API_domains_ListDomains_RequestSyntax) **   <a name="Route53Domains-domains_ListDomains-request-SortCondition"></a>
A complex type that contains information about the requested ordering of domains in the returned list.  
Type: [SortCondition](API_domains_SortCondition.md) object  
Required: No

## Response Syntax
<a name="API_domains_ListDomains_ResponseSyntax"></a>

```
{
   "Domains": [ 
      { 
         "AutoRenew": boolean,
         "DomainName": "string",
         "Expiry": number,
         "TransferLock": boolean
      }
   ],
   "NextPageMarker": "string"
}
```

## Response Elements
<a name="API_domains_ListDomains_ResponseElements"></a>

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

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

 ** [Domains](#API_domains_ListDomains_ResponseSyntax) **   <a name="Route53Domains-domains_ListDomains-response-Domains"></a>
A list of domains.  
Type: Array of [DomainSummary](API_domains_DomainSummary.md) objects

 ** [NextPageMarker](#API_domains_ListDomains_ResponseSyntax) **   <a name="Route53Domains-domains_ListDomains-response-NextPageMarker"></a>
If there are more domains than you specified for `MaxItems` in the request, submit another request and include the value of `NextPageMarker` in the value of `Marker`.  
Type: String  
Length Constraints: Maximum length of 4096.

## Errors
<a name="API_domains_ListDomains_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

## Examples
<a name="API_domains_ListDomains_Examples"></a>

### ListDomains Example
<a name="API_domains_ListDomains_Example_1"></a>

This example illustrates one usage of ListDomains.

#### Sample Request
<a name="API_domains_ListDomains_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.ListDomains
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "Marker":"AxDAClaROQAXasf29GHWAIKPLA=",
   "MaxItems":20
}
```

#### Sample Response
<a name="API_domains_ListDomains_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "Domains":[
      {
         "AutoRenew":false,
         "DomainName":"example.com",
         "Expiry":1431203765,
         "TransferLock":false
      },
      {
         "AutoRenew":false,
         "DomainName":"example.net",
         "Expiry":1431539260,
         "TransferLock":false
      },
      {
         "AutoRenew":false,
         "DomainName":"example.org",
         "Expiry":1431240024,
         "TransferLock":false
      },
      {
         "AutoRenew":false,
         "DomainName":"example.test",
         "Expiry":1431539259,
         "TransferLock":false
      }
   ]
}
```

## See Also
<a name="API_domains_ListDomains_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/ListDomains) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/ListDomains) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/ListDomains) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/ListDomains) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListDomains) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/ListDomains) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/ListDomains) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/ListDomains) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/ListDomains) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/ListDomains) 

# ListOperations
<a name="API_domains_ListOperations"></a>

Returns information about all of the operations that return an operation ID and that have ever been performed on domains that were registered by the current account. 

This command runs only in the us-east-1 Region.

## Request Syntax
<a name="API_domains_ListOperations_RequestSyntax"></a>

```
{
   "Marker": "string",
   "MaxItems": number,
   "SortBy": "string",
   "SortOrder": "string",
   "Status": [ "string" ],
   "SubmittedSince": number,
   "Type": [ "string" ]
}
```

## Request Parameters
<a name="API_domains_ListOperations_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [Marker](#API_domains_ListOperations_RequestSyntax) **   <a name="Route53Domains-domains_ListOperations-request-Marker"></a>
For an initial request for a list of operations, omit this element. If the number of operations that are not yet complete is greater than the value that you specified for `MaxItems`, you can use `Marker` to return additional operations. Get the value of `NextPageMarker` from the previous response, and submit another request that includes the value of `NextPageMarker` in the `Marker` element.  
Type: String  
Length Constraints: Maximum length of 4096.  
Required: No

 ** [MaxItems](#API_domains_ListOperations_RequestSyntax) **   <a name="Route53Domains-domains_ListOperations-request-MaxItems"></a>
Number of domains to be returned.  
Default: 20  
Type: Integer  
Valid Range: Maximum value of 100.  
Required: No

 ** [SortBy](#API_domains_ListOperations_RequestSyntax) **   <a name="Route53Domains-domains_ListOperations-request-SortBy"></a>
 The sort type for returned values.   
Type: String  
Valid Values: `SubmittedDate`   
Required: No

 ** [SortOrder](#API_domains_ListOperations_RequestSyntax) **   <a name="Route53Domains-domains_ListOperations-request-SortOrder"></a>
 The sort order for returned values, either ascending or descending.   
Type: String  
Valid Values: `ASC | DESC`   
Required: No

 ** [Status](#API_domains_ListOperations_RequestSyntax) **   <a name="Route53Domains-domains_ListOperations-request-Status"></a>
 The status of the operations.   
Type: Array of strings  
Array Members: Maximum number of 5 items.  
Valid Values: `SUBMITTED | IN_PROGRESS | ERROR | SUCCESSFUL | FAILED`   
Required: No

 ** [SubmittedSince](#API_domains_ListOperations_RequestSyntax) **   <a name="Route53Domains-domains_ListOperations-request-SubmittedSince"></a>
An optional parameter that lets you get information about all the operations that you submitted after a specified date and time. Specify the date and time in Unix time format and Coordinated Universal time (UTC).  
Type: Timestamp  
Required: No

 ** [Type](#API_domains_ListOperations_RequestSyntax) **   <a name="Route53Domains-domains_ListOperations-request-Type"></a>
 An arrays of the domains operation types.   
Type: Array of strings  
Array Members: Maximum number of 21 items.  
Valid Values: `REGISTER_DOMAIN | DELETE_DOMAIN | TRANSFER_IN_DOMAIN | UPDATE_DOMAIN_CONTACT | UPDATE_NAMESERVER | CHANGE_PRIVACY_PROTECTION | DOMAIN_LOCK | ENABLE_AUTORENEW | DISABLE_AUTORENEW | ADD_DNSSEC | REMOVE_DNSSEC | EXPIRE_DOMAIN | TRANSFER_OUT_DOMAIN | CHANGE_DOMAIN_OWNER | RENEW_DOMAIN | PUSH_DOMAIN | INTERNAL_TRANSFER_OUT_DOMAIN | INTERNAL_TRANSFER_IN_DOMAIN | RELEASE_TO_GANDI | TRANSFER_ON_RENEW | RESTORE_DOMAIN`   
Required: No

## Response Syntax
<a name="API_domains_ListOperations_ResponseSyntax"></a>

```
{
   "NextPageMarker": "string",
   "Operations": [ 
      { 
         "DomainName": "string",
         "LastUpdatedDate": number,
         "Message": "string",
         "OperationId": "string",
         "Status": "string",
         "StatusFlag": "string",
         "SubmittedDate": number,
         "Type": "string"
      }
   ]
}
```

## Response Elements
<a name="API_domains_ListOperations_ResponseElements"></a>

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

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

 ** [NextPageMarker](#API_domains_ListOperations_ResponseSyntax) **   <a name="Route53Domains-domains_ListOperations-response-NextPageMarker"></a>
If there are more operations than you specified for `MaxItems` in the request, submit another request and include the value of `NextPageMarker` in the value of `Marker`.  
Type: String  
Length Constraints: Maximum length of 4096.

 ** [Operations](#API_domains_ListOperations_ResponseSyntax) **   <a name="Route53Domains-domains_ListOperations-response-Operations"></a>
Lists summaries of the operations.  
Type: Array of [OperationSummary](API_domains_OperationSummary.md) objects

## Errors
<a name="API_domains_ListOperations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

## Examples
<a name="API_domains_ListOperations_Examples"></a>

### ListOperations Example
<a name="API_domains_ListOperations_Example_1"></a>

This example illustrates one usage of ListOperations.

#### Sample Request
<a name="API_domains_ListOperations_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.ListOperations
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "MaxItems" : 2
}
```

#### Sample Response
<a name="API_domains_ListOperations_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "Operations":[
       {
         "OperationId":"4ced3d4a-e011-45ee-b94f-1e2d73477562",
         "Status":"WORKFLOW_IN_PROGRESS",
         "SubmittedDate":1403548979.088,
         "Type":"CHANGE_PRIVACY_PROTECTION"
      },
      {
         "OperationId":"2e3ac45b-89b3-47ea-a042-f56dcd1b6883",
         "Status":"WORKFLOW_IN_PROGRESS",
         "SubmittedDate":1403548986.429,
         "Type":"DOMAIN_LOCK"
      }
   ]
}
```

## See Also
<a name="API_domains_ListOperations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/ListOperations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/ListOperations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/ListOperations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/ListOperations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListOperations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/ListOperations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/ListOperations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/ListOperations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/ListOperations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/ListOperations) 

# ListPrices
<a name="API_domains_ListPrices"></a>

Lists the following prices for either all the TLDs supported by Route 53, or the specified TLD:
+ Registration
+ Transfer
+ Owner change
+ Domain renewal
+ Domain restoration

## Request Syntax
<a name="API_domains_ListPrices_RequestSyntax"></a>

```
{
   "Marker": "string",
   "MaxItems": number,
   "Tld": "string"
}
```

## Request Parameters
<a name="API_domains_ListPrices_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [Marker](#API_domains_ListPrices_RequestSyntax) **   <a name="Route53Domains-domains_ListPrices-request-Marker"></a>
For an initial request for a list of prices, omit this element. If the number of prices that are not yet complete is greater than the value that you specified for `MaxItems`, you can use `Marker` to return additional prices. Get the value of `NextPageMarker` from the previous response, and submit another request that includes the value of `NextPageMarker` in the `Marker` element.   
Used only for all TLDs. If you specify a TLD, don't specify a `Marker`.  
Type: String  
Length Constraints: Maximum length of 4096.  
Required: No

 ** [MaxItems](#API_domains_ListPrices_RequestSyntax) **   <a name="Route53Domains-domains_ListPrices-request-MaxItems"></a>
Number of `Prices` to be returned.  
Used only for all TLDs. If you specify a TLD, don't specify a `MaxItems`.  
Type: Integer  
Valid Range: Maximum value of 1000.  
Required: No

 ** [Tld](#API_domains_ListPrices_RequestSyntax) **   <a name="Route53Domains-domains_ListPrices-request-Tld"></a>
The TLD for which you want to receive the pricing information. For example. `.net`.  
If a `Tld` value is not provided, a list of prices for all TLDs supported by Route 53 is returned.  
Type: String  
Length Constraints: Minimum length of 2. Maximum length of 255.  
Required: No

## Response Syntax
<a name="API_domains_ListPrices_ResponseSyntax"></a>

```
{
   "NextPageMarker": "string",
   "Prices": [ 
      { 
         "ChangeOwnershipPrice": { 
            "Currency": "string",
            "Price": number
         },
         "Name": "string",
         "RegistrationPrice": { 
            "Currency": "string",
            "Price": number
         },
         "RenewalPrice": { 
            "Currency": "string",
            "Price": number
         },
         "RestorationPrice": { 
            "Currency": "string",
            "Price": number
         },
         "TransferPrice": { 
            "Currency": "string",
            "Price": number
         }
      }
   ]
}
```

## Response Elements
<a name="API_domains_ListPrices_ResponseElements"></a>

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

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

 ** [NextPageMarker](#API_domains_ListPrices_ResponseSyntax) **   <a name="Route53Domains-domains_ListPrices-response-NextPageMarker"></a>
If there are more prices than you specified for `MaxItems` in the request, submit another request and include the value of `NextPageMarker` in the value of `Marker`.   
Used only for all TLDs. If you specify a TLD, don't specify a `NextPageMarker`.  
Type: String  
Length Constraints: Maximum length of 4096.

 ** [Prices](#API_domains_ListPrices_ResponseSyntax) **   <a name="Route53Domains-domains_ListPrices-response-Prices"></a>
A complex type that includes all the pricing information. If you specify a TLD, this array contains only the pricing for that TLD.  
Type: Array of [DomainPrice](API_domains_DomainPrice.md) objects

## Errors
<a name="API_domains_ListPrices_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## See Also
<a name="API_domains_ListPrices_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/ListPrices) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/ListPrices) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/ListPrices) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/ListPrices) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListPrices) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/ListPrices) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/ListPrices) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/ListPrices) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/ListPrices) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/ListPrices) 

# ListTagsForDomain
<a name="API_domains_ListTagsForDomain"></a>

This operation returns all of the tags that are associated with the specified domain.

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

## Request Syntax
<a name="API_domains_ListTagsForDomain_RequestSyntax"></a>

```
{
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_ListTagsForDomain_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_ListTagsForDomain_RequestSyntax) **   <a name="Route53Domains-domains_ListTagsForDomain-request-DomainName"></a>
The domain for which you want to get a list of tags.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_domains_ListTagsForDomain_ResponseSyntax"></a>

```
{
   "TagList": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Response Elements
<a name="API_domains_ListTagsForDomain_ResponseElements"></a>

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

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

 ** [TagList](#API_domains_ListTagsForDomain_ResponseSyntax) **   <a name="Route53Domains-domains_ListTagsForDomain-response-TagList"></a>
A list of the tags that are associated with the specified domain.  
Type: Array of [Tag](API_domains_Tag.md) objects

## Errors
<a name="API_domains_ListTagsForDomain_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_ListTagsForDomain_Examples"></a>

### ListTagsForDomain Example
<a name="API_domains_ListTagsForDomain_Example_1"></a>

This example illustrates one usage of ListTagsForDomain.

#### Sample Request
<a name="API_domains_ListTagsForDomain_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.ListTagsForDomain
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_ListTagsForDomain_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "tagList":[
      {
         "Key": "key1",
         "Value": "value1"
      }, {
         "Key": "key2",
         "Value": "value2"
      }
   ]
}
```

## See Also
<a name="API_domains_ListTagsForDomain_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/ListTagsForDomain) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/ListTagsForDomain) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/ListTagsForDomain) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/ListTagsForDomain) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListTagsForDomain) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/ListTagsForDomain) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/ListTagsForDomain) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/ListTagsForDomain) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/ListTagsForDomain) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/ListTagsForDomain) 

# PushDomain
<a name="API_domains_PushDomain"></a>

 Moves a domain from AWS to another registrar. 

Supported actions:
+ Changes the IPS tags of a .uk domain, and pushes it to transit. Transit means that the domain is ready to be transferred to another registrar.

## Request Syntax
<a name="API_domains_PushDomain_RequestSyntax"></a>

```
{
   "DomainName": "string",
   "Target": "string"
}
```

## Request Parameters
<a name="API_domains_PushDomain_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_PushDomain_RequestSyntax) **   <a name="Route53Domains-domains_PushDomain-request-DomainName"></a>
 Name of the domain.   
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [Target](#API_domains_PushDomain_RequestSyntax) **   <a name="Route53Domains-domains_PushDomain-request-Target"></a>
 New IPS tag for the domain.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: Yes

## Response Elements
<a name="API_domains_PushDomain_ResponseElements"></a>

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

## Errors
<a name="API_domains_PushDomain_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## See Also
<a name="API_domains_PushDomain_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/PushDomain) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/PushDomain) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/PushDomain) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/PushDomain) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/PushDomain) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/PushDomain) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/PushDomain) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/PushDomain) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/PushDomain) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/PushDomain) 

# RegisterDomain
<a name="API_domains_RegisterDomain"></a>

This operation registers a domain. For some top-level domains (TLDs), this operation requires extra parameters.

When you register a domain, Amazon Route 53 does the following:
+ Creates a Route 53 hosted zone that has the same name as the domain. Route 53 assigns four name servers to your hosted zone and automatically updates your domain registration with the names of these name servers.
+ Enables auto renew, so your domain registration will renew automatically each year. We'll notify you in advance of the renewal date so you can choose whether to renew the registration.
+ Optionally enables privacy protection, so WHOIS queries return contact for the registrar or the phrase "REDACTED FOR PRIVACY", or "On behalf of <domain name> owner." If you don't enable privacy protection, WHOIS queries return the information that you entered for the administrative, registrant, and technical contacts.
**Note**  
While some domains may allow different privacy settings per contact, we recommend specifying the same privacy setting for all contacts.
+ If registration is successful, returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant is notified by email.
+ Charges your AWS account an amount based on the top-level domain. For more information, see [Amazon Route 53 Pricing](http://aws.amazon.com/route53/pricing/).

## Request Syntax
<a name="API_domains_RegisterDomain_RequestSyntax"></a>

```
{
   "AdminContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "AutoRenew": boolean,
   "BillingContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "DomainName": "string",
   "DurationInYears": number,
   "IdnLangCode": "string",
   "PrivacyProtectAdminContact": boolean,
   "PrivacyProtectBillingContact": boolean,
   "PrivacyProtectRegistrantContact": boolean,
   "PrivacyProtectTechContact": boolean,
   "RegistrantContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "TechContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   }
}
```

## Request Parameters
<a name="API_domains_RegisterDomain_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [AdminContact](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-AdminContact"></a>
Provides detailed contact information. For information about the values that you specify for each element, see [ContactDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ContactDetail.html).  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: Yes

 ** [AutoRenew](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-AutoRenew"></a>
Indicates whether the domain will be automatically renewed (`true`) or not (`false`). Auto renewal only takes effect after the account is charged.  
Default: `true`   
Type: Boolean  
Required: No

 ** [BillingContact](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-BillingContact"></a>
Provides detailed contact information. For information about the values that you specify for each element, see [ContactDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ContactDetail.html).  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: No

 ** [DomainName](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-DomainName"></a>
The domain name that you want to register. The top-level domain (TLD), such as .com, must be a TLD that Route 53 supports. For a list of supported TLDs, see [Domains that You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) in the *Amazon Route 53 Developer Guide*.  
The domain name can contain only the following characters:  
+ Letters a through z. Domain names are not case sensitive.
+ Numbers 0 through 9.
+ Hyphen (-). You can't specify a hyphen at the beginning or end of a label. 
+ Period (.) to separate the labels in the name, such as the `.` in `example.com`.
Internationalized domain names are not supported for some top-level domains. To determine whether the TLD that you want to use supports internationalized domain names, see [Domains that You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html). For more information, see [Formatting Internationalized Domain Names](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.html#domain-name-format-idns).   
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [DurationInYears](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-DurationInYears"></a>
The number of years that you want to register the domain for. Domains are registered for a minimum of one year. The maximum period depends on the top-level domain. For the range of valid values for your domain, see [Domains that You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) in the *Amazon Route 53 Developer Guide*.  
Default: 1  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10.  
Required: Yes

 ** [IdnLangCode](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-IdnLangCode"></a>
Reserved for future use.  
Type: String  
Pattern: `|[A-Za-z]{2,3}`   
Required: No

 ** [PrivacyProtectAdminContact](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-PrivacyProtectAdminContact"></a>
Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify `false`, WHOIS queries return the information that you entered for the admin contact.  
You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.
Default: `true`   
Type: Boolean  
Required: No

 ** [PrivacyProtectBillingContact](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-PrivacyProtectBillingContact"></a>
Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify `false`, WHOIS queries return the information that you entered for the billing contact.  
You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.
Type: Boolean  
Required: No

 ** [PrivacyProtectRegistrantContact](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-PrivacyProtectRegistrantContact"></a>
Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify `false`, WHOIS queries return the information that you entered for the registrant contact (the domain owner).  
You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.
Default: `true`   
Type: Boolean  
Required: No

 ** [PrivacyProtectTechContact](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-PrivacyProtectTechContact"></a>
Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify `false`, WHOIS queries return the information that you entered for the technical contact.  
You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.
Default: `true`   
Type: Boolean  
Required: No

 ** [RegistrantContact](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-RegistrantContact"></a>
Provides detailed contact information. For information about the values that you specify for each element, see [ContactDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ContactDetail.html).  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: Yes

 ** [TechContact](#API_domains_RegisterDomain_RequestSyntax) **   <a name="Route53Domains-domains_RegisterDomain-request-TechContact"></a>
Provides detailed contact information. For information about the values that you specify for each element, see [ContactDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ContactDetail.html).  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: Yes

## Response Syntax
<a name="API_domains_RegisterDomain_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_RegisterDomain_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_RegisterDomain_ResponseSyntax) **   <a name="Route53Domains-domains_RegisterDomain-response-OperationId"></a>
Identifier for tracking the progress of the request. To query the operation status, use [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html).  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_RegisterDomain_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DomainLimitExceeded **   
The number of domains has exceeded the allowed threshold for the account.    
 ** message **   
The number of domains has exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_RegisterDomain_Examples"></a>

### RegisterDomain Example
<a name="API_domains_RegisterDomain_Example_1"></a>

This example illustrates one usage of RegisterDomain.

#### Sample Request
<a name="API_domains_RegisterDomain_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.RegisterDomain
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com",
   "DurationInYears":1,
   "AutoRenew":true,
   "AdminContact":{
      "FirstName":"John",
      "MiddleName":"Richard",
      "LastName":"Doe",
      "ContactType":"PERSON",
      "OrganizationName":"",
      "AddressLine1":"123 Any Street",
      "AddressLine2":"",
      "City":"Any Town",
      "State":"WA",
      "CountryCode":"US",
      "ZipCode":"98101",
      "PhoneNumber":"+1.1234567890",
      "Email":"john@example.com",
      "Fax":"+1.1234567891"
   },
   "RegistrantContact":{
      "FirstName":"John",
      "MiddleName":"Richard",
      "LastName":"Doe",
      "ContactType":"PERSON",
      "OrganizationName":"",
      "AddressLine1":"123 Any Street",
      "AddressLine2":"",
      "City":"Any Town",
      "State":"WA",
      "CountryCode":"US",
      "ZipCode":"98101",
      "PhoneNumber":"+1.1234567890",
      "Email":"john@example.com",
      "Fax":"+1.1234567891"
   },
   "TechContact":{
      "FirstName":"John",
      "MiddleName":"Richard",
      "LastName":"Doe",
      "ContactType":"PERSON",
      "OrganizationName":"",
      "AddressLine1":"123 Any Street",
      "AddressLine2":"",
      "City":"Any Town",
      "State":"WA",
      "CountryCode":"US",
      "ZipCode":"98101",
      "PhoneNumber":"+1.1234567890",
      "Email":"john@example.com",
      "Fax":"+1.1234567891"
},
"PrivacyProtectAdminContact":true,
"PrivacyProtectRegistrantContact":true,
"PrivacyProtectTechContact":true
}
```

#### Sample Response
<a name="API_domains_RegisterDomain_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "OperationId":"308c56712-faa4-40fe-94c8-b423069de3f6"
}
```

## See Also
<a name="API_domains_RegisterDomain_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/RegisterDomain) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/RegisterDomain) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/RegisterDomain) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/RegisterDomain) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/RegisterDomain) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/RegisterDomain) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/RegisterDomain) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/RegisterDomain) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/RegisterDomain) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/RegisterDomain) 

# RejectDomainTransferFromAnotherAwsAccount
<a name="API_domains_RejectDomainTransferFromAnotherAwsAccount"></a>

Rejects the transfer of a domain from another AWS account to the current AWS account. You initiate a transfer betweenAWS accounts using [TransferDomainToAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_TransferDomainToAnotherAwsAccount.html). 

Use either [ListOperations](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ListOperations.html) or [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html) to determine whether the operation succeeded. [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html) provides additional information, for example, `Domain Transfer from Aws Account 111122223333 has been cancelled`. 

## Request Syntax
<a name="API_domains_RejectDomainTransferFromAnotherAwsAccount_RequestSyntax"></a>

```
{
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_RejectDomainTransferFromAnotherAwsAccount_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_RejectDomainTransferFromAnotherAwsAccount_RequestSyntax) **   <a name="Route53Domains-domains_RejectDomainTransferFromAnotherAwsAccount-request-DomainName"></a>
The name of the domain that was specified when another AWS account submitted a [TransferDomainToAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_TransferDomainToAnotherAwsAccount.html) request.   
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_domains_RejectDomainTransferFromAnotherAwsAccount_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_RejectDomainTransferFromAnotherAwsAccount_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_RejectDomainTransferFromAnotherAwsAccount_ResponseSyntax) **   <a name="Route53Domains-domains_RejectDomainTransferFromAnotherAwsAccount-response-OperationId"></a>
The identifier that `TransferDomainToAnotherAwsAccount` returned to track the progress of the request. Because the transfer request was rejected, the value is no longer valid, and you can't use `GetOperationDetail` to query the operation status.  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_RejectDomainTransferFromAnotherAwsAccount_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_RejectDomainTransferFromAnotherAwsAccount_Examples"></a>

### RejectDomainTransferFromAnotherAwsAccount Example
<a name="API_domains_RejectDomainTransferFromAnotherAwsAccount_Example_1"></a>

This example illustrates one usage of RejectDomainTransferFromAnotherAwsAccount.

#### Sample Request
<a name="API_domains_RejectDomainTransferFromAnotherAwsAccount_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20200311T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.RejectDomainTransferFromAnotherAwsAccount
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
    "DomainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_RejectDomainTransferFromAnotherAwsAccount_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
    "OperationId":"308c56712-faa4-40fe-94c8-b4230example"
}
```

## See Also
<a name="API_domains_RejectDomainTransferFromAnotherAwsAccount_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/RejectDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/RejectDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/RejectDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/RejectDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/RejectDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/RejectDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/RejectDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/RejectDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/RejectDomainTransferFromAnotherAwsAccount) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/RejectDomainTransferFromAnotherAwsAccount) 

# RenewDomain
<a name="API_domains_RenewDomain"></a>

This operation renews a domain for the specified number of years. The cost of renewing your domain is billed to your AWS account.

We recommend that you renew your domain several weeks before the expiration date. Some TLD registries delete domains before the expiration date if you haven't renewed far enough in advance. For more information about renewing domain registration, see [Renewing Registration for a Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-renew.html) in the *Amazon Route 53 Developer Guide*.

## Request Syntax
<a name="API_domains_RenewDomain_RequestSyntax"></a>

```
{
   "CurrentExpiryYear": number,
   "DomainName": "string",
   "DurationInYears": number
}
```

## Request Parameters
<a name="API_domains_RenewDomain_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [CurrentExpiryYear](#API_domains_RenewDomain_RequestSyntax) **   <a name="Route53Domains-domains_RenewDomain-request-CurrentExpiryYear"></a>
The year when the registration for the domain is set to expire. This value must match the current expiration date for the domain.  
Type: Integer  
Required: Yes

 ** [DomainName](#API_domains_RenewDomain_RequestSyntax) **   <a name="Route53Domains-domains_RenewDomain-request-DomainName"></a>
The name of the domain that you want to renew.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [DurationInYears](#API_domains_RenewDomain_RequestSyntax) **   <a name="Route53Domains-domains_RenewDomain-request-DurationInYears"></a>
The number of years that you want to renew the domain for. The maximum number of years depends on the top-level domain. For the range of valid values for your domain, see [Domains that You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) in the *Amazon Route 53 Developer Guide*.  
Default: 1  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10.  
Required: No

## Response Syntax
<a name="API_domains_RenewDomain_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_RenewDomain_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_RenewDomain_ResponseSyntax) **   <a name="Route53Domains-domains_RenewDomain-response-OperationId"></a>
Identifier for tracking the progress of the request. To query the operation status, use [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html).  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_RenewDomain_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_RenewDomain_Examples"></a>

### RenewDomain Example
<a name="API_domains_RenewDomain_Example_1"></a>

This example illustrates one usage of RenewDomain.

#### Sample Request
<a name="API_domains_RenewDomain_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
              x-amz-target:Route53Domains_v20140515.RenewDomain
              user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com",
   "DurationInYears":"6",
   "CurrentExpiryYear":"2017"
}
```

#### Sample Response
<a name="API_domains_RenewDomain_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]{}
```

## See Also
<a name="API_domains_RenewDomain_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/RenewDomain) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/RenewDomain) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/RenewDomain) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/RenewDomain) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/RenewDomain) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/RenewDomain) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/RenewDomain) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/RenewDomain) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/RenewDomain) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/RenewDomain) 

# ResendContactReachabilityEmail
<a name="API_domains_ResendContactReachabilityEmail"></a>

For operations that require confirmation that the email address for the registrant contact is valid, such as registering a new domain, this operation resends the confirmation email to the current email address for the registrant contact.

## Request Syntax
<a name="API_domains_ResendContactReachabilityEmail_RequestSyntax"></a>

```
{
   "domainName": "string"
}
```

## Request Parameters
<a name="API_domains_ResendContactReachabilityEmail_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [domainName](#API_domains_ResendContactReachabilityEmail_RequestSyntax) **   <a name="Route53Domains-domains_ResendContactReachabilityEmail-request-domainName"></a>
The name of the domain for which you want Route 53 to resend a confirmation email to the registrant contact.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: No

## Response Syntax
<a name="API_domains_ResendContactReachabilityEmail_ResponseSyntax"></a>

```
{
   "domainName": "string",
   "emailAddress": "string",
   "isAlreadyVerified": boolean
}
```

## Response Elements
<a name="API_domains_ResendContactReachabilityEmail_ResponseElements"></a>

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

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

 ** [domainName](#API_domains_ResendContactReachabilityEmail_ResponseSyntax) **   <a name="Route53Domains-domains_ResendContactReachabilityEmail-response-domainName"></a>
The domain name for which you requested a confirmation email.  
Type: String  
Length Constraints: Maximum length of 255.

 ** [emailAddress](#API_domains_ResendContactReachabilityEmail_ResponseSyntax) **   <a name="Route53Domains-domains_ResendContactReachabilityEmail-response-emailAddress"></a>
The email address for the registrant contact at the time that we sent the verification email.  
Type: String  
Length Constraints: Maximum length of 254.

 ** [isAlreadyVerified](#API_domains_ResendContactReachabilityEmail_ResponseSyntax) **   <a name="Route53Domains-domains_ResendContactReachabilityEmail-response-isAlreadyVerified"></a>
 `True` if the email address for the registrant contact has already been verified, and `false` otherwise. If the email address has already been verified, we don't send another confirmation email.  
Type: Boolean

## Errors
<a name="API_domains_ResendContactReachabilityEmail_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_ResendContactReachabilityEmail_Examples"></a>

### ResendContactReachabilityEmail Example
<a name="API_domains_ResendContactReachabilityEmail_Example_1"></a>

This example illustrates one usage of ResendContactReachabilityEmail.

#### Sample Request
<a name="API_domains_ResendContactReachabilityEmail_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205225Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.ResendContactReachabilityEmail
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
connections:Keep-Alive
{
   "domainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_ResendContactReachabilityEmail_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "domainName":"example.com",
   "emailAddress":"jdoe@example.com",
   "status":"PENDING"
}
```

## See Also
<a name="API_domains_ResendContactReachabilityEmail_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/ResendContactReachabilityEmail) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/ResendContactReachabilityEmail) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/ResendContactReachabilityEmail) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/ResendContactReachabilityEmail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ResendContactReachabilityEmail) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/ResendContactReachabilityEmail) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/ResendContactReachabilityEmail) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/ResendContactReachabilityEmail) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/ResendContactReachabilityEmail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/ResendContactReachabilityEmail) 

# ResendOperationAuthorization
<a name="API_domains_ResendOperationAuthorization"></a>

 Resend the form of authorization email for this operation. 

## Request Syntax
<a name="API_domains_ResendOperationAuthorization_RequestSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Request Parameters
<a name="API_domains_ResendOperationAuthorization_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [OperationId](#API_domains_ResendOperationAuthorization_RequestSyntax) **   <a name="Route53Domains-domains_ResendOperationAuthorization-request-OperationId"></a>
 Operation ID.   
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Elements
<a name="API_domains_ResendOperationAuthorization_ResponseElements"></a>

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

## Errors
<a name="API_domains_ResendOperationAuthorization_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

## See Also
<a name="API_domains_ResendOperationAuthorization_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/ResendOperationAuthorization) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/ResendOperationAuthorization) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/ResendOperationAuthorization) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/ResendOperationAuthorization) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ResendOperationAuthorization) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/ResendOperationAuthorization) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/ResendOperationAuthorization) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/ResendOperationAuthorization) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/ResendOperationAuthorization) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/ResendOperationAuthorization) 

# RetrieveDomainAuthCode
<a name="API_domains_RetrieveDomainAuthCode"></a>

This operation returns the authorization code for the domain. To transfer a domain to another registrar, you provide this value to the new registrar.

## Request Syntax
<a name="API_domains_RetrieveDomainAuthCode_RequestSyntax"></a>

```
{
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_RetrieveDomainAuthCode_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_RetrieveDomainAuthCode_RequestSyntax) **   <a name="Route53Domains-domains_RetrieveDomainAuthCode-request-DomainName"></a>
The name of the domain that you want to get an authorization code for.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_domains_RetrieveDomainAuthCode_ResponseSyntax"></a>

```
{
   "AuthCode": "string"
}
```

## Response Elements
<a name="API_domains_RetrieveDomainAuthCode_ResponseElements"></a>

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

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

 ** [AuthCode](#API_domains_RetrieveDomainAuthCode_ResponseSyntax) **   <a name="Route53Domains-domains_RetrieveDomainAuthCode-response-AuthCode"></a>
The authorization code for the domain.  
Type: String  
Length Constraints: Maximum length of 1024.

## Errors
<a name="API_domains_RetrieveDomainAuthCode_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_RetrieveDomainAuthCode_Examples"></a>

### RetrieveDomainAuthCode Example
<a name="API_domains_RetrieveDomainAuthCode_Example_1"></a>

This example illustrates one usage of RetrieveDomainAuthCode.

#### Sample Request
<a name="API_domains_RetrieveDomainAuthCode_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.RetrieveDomainAuthCode
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com"
}
```

#### Sample Response
<a name="API_domains_RetrieveDomainAuthCode_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "AuthCode":"rqL3*REjYH"
}
```

## See Also
<a name="API_domains_RetrieveDomainAuthCode_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/RetrieveDomainAuthCode) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/RetrieveDomainAuthCode) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/RetrieveDomainAuthCode) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/RetrieveDomainAuthCode) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/RetrieveDomainAuthCode) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/RetrieveDomainAuthCode) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/RetrieveDomainAuthCode) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/RetrieveDomainAuthCode) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/RetrieveDomainAuthCode) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/RetrieveDomainAuthCode) 

# TransferDomain
<a name="API_domains_TransferDomain"></a>

Transfers a domain from another registrar to Amazon Route 53. 

For more information about transferring domains, see the following topics:
+ For transfer requirements, a detailed procedure, and information about viewing the status of a domain that you're transferring to Route 53, see [Transferring Registration for a Domain to Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-to-route-53.html) in the *Amazon Route 53 Developer Guide*.
+ For information about how to transfer a domain from one AWS account to another, see [TransferDomainToAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_TransferDomainToAnotherAwsAccount.html). 
+ For information about how to transfer a domain to another domain registrar, see [Transferring a Domain from Amazon Route 53 to Another Registrar](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html) in the *Amazon Route 53 Developer Guide*.

**Important**  
During the transfer of any country code top-level domains (ccTLDs) to Route 53, except for .cc and .tv, updates to the owner contact are ignored and the owner contact data from the registry is used. You can update the owner contact after the transfer is complete. For more information, see [UpdateDomainContact](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_UpdateDomainContact.html).

If the registrar for your domain is also the DNS service provider for the domain, we highly recommend that you transfer your DNS service to Route 53 or to another DNS service provider before you transfer your registration. Some registrars provide free DNS service when you purchase a domain registration. When you transfer the registration, the previous registrar will not renew your domain registration and could end your DNS service at any time.

**Important**  
If the registrar for your domain is also the DNS service provider for the domain and you don't transfer DNS service to another provider, your website, email, and the web applications associated with the domain might become unavailable.

If the transfer is successful, this method returns an operation ID that you can use to track the progress and completion of the action. If the transfer doesn't complete successfully, the domain registrant will be notified by email.

## Request Syntax
<a name="API_domains_TransferDomain_RequestSyntax"></a>

```
{
   "AdminContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "AuthCode": "string",
   "AutoRenew": boolean,
   "BillingContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "DomainName": "string",
   "DurationInYears": number,
   "IdnLangCode": "string",
   "Nameservers": [ 
      { 
         "GlueIps": [ "string" ],
         "Name": "string"
      }
   ],
   "PrivacyProtectAdminContact": boolean,
   "PrivacyProtectBillingContact": boolean,
   "PrivacyProtectRegistrantContact": boolean,
   "PrivacyProtectTechContact": boolean,
   "RegistrantContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "TechContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   }
}
```

## Request Parameters
<a name="API_domains_TransferDomain_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [AdminContact](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-AdminContact"></a>
Provides detailed contact information.  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: Yes

 ** [AuthCode](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-AuthCode"></a>
The authorization code for the domain. You get this value from the current registrar.  
Type: String  
Length Constraints: Maximum length of 1024.  
Required: No

 ** [AutoRenew](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-AutoRenew"></a>
Indicates whether the domain will be automatically renewed (true) or not (false). Auto renewal only takes effect after the account is charged.  
Default: true  
Type: Boolean  
Required: No

 ** [BillingContact](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-BillingContact"></a>
Provides detailed contact information.  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: No

 ** [DomainName](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-DomainName"></a>
The name of the domain that you want to transfer to Route 53. The top-level domain (TLD), such as .com, must be a TLD that Route 53 supports. For a list of supported TLDs, see [Domains that You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) in the *Amazon Route 53 Developer Guide*.  
The domain name can contain only the following characters:  
+ Letters a through z. Domain names are not case sensitive.
+ Numbers 0 through 9.
+ Hyphen (-). You can't specify a hyphen at the beginning or end of a label. 
+ Period (.) to separate the labels in the name, such as the `.` in `example.com`.
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [DurationInYears](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-DurationInYears"></a>
Reserved for future use.  
Currently, the effect of a domain transfer on the registration period varies by TLD. For information about how transferring a domain affects the expiration date, see the Transfer Term column in the pricing information at [Amazon Route 53 Pricing](http://aws.amazon.com/route53/pricing/).  
Default: 1  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10.  
Required: No

 ** [IdnLangCode](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-IdnLangCode"></a>
Reserved for future use.  
Type: String  
Pattern: `|[A-Za-z]{2,3}`   
Required: No

 ** [Nameservers](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-Nameservers"></a>
Contains details for the host and glue IP addresses.  
Type: Array of [Nameserver](API_domains_Nameserver.md) objects  
Required: No

 ** [PrivacyProtectAdminContact](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-PrivacyProtectAdminContact"></a>
Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information for the registrar, the phrase "REDACTED FOR PRIVACY", or "On behalf of <domain name> owner.".  
While some domains may allow different privacy settings per contact, we recommend specifying the same privacy setting for all contacts.
Default: `true`   
Type: Boolean  
Required: No

 ** [PrivacyProtectBillingContact](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-PrivacyProtectBillingContact"></a>
 Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify `false`, WHOIS queries return the information that you entered for the billing contact.   
You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.
Type: Boolean  
Required: No

 ** [PrivacyProtectRegistrantContact](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-PrivacyProtectRegistrantContact"></a>
Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify `false`, WHOIS queries return the information that you entered for the registrant contact (domain owner).  
You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.
Default: `true`   
Type: Boolean  
Required: No

 ** [PrivacyProtectTechContact](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-PrivacyProtectTechContact"></a>
Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify `false`, WHOIS queries return the information that you entered for the technical contact.  
You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.
Default: `true`   
Type: Boolean  
Required: No

 ** [RegistrantContact](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-RegistrantContact"></a>
Provides detailed contact information.  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: Yes

 ** [TechContact](#API_domains_TransferDomain_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomain-request-TechContact"></a>
Provides detailed contact information.  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: Yes

## Response Syntax
<a name="API_domains_TransferDomain_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_TransferDomain_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_TransferDomain_ResponseSyntax) **   <a name="Route53Domains-domains_TransferDomain-response-OperationId"></a>
Identifier for tracking the progress of the request. To query the operation status, use [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html).  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_TransferDomain_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DomainLimitExceeded **   
The number of domains has exceeded the allowed threshold for the account.    
 ** message **   
The number of domains has exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_TransferDomain_Examples"></a>

### TransferDomain Example
<a name="API_domains_TransferDomain_Example_1"></a>

This example illustrates one usage of TransferDomain.

#### Sample Request
<a name="API_domains_TransferDomain_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.TransferDomain
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com",
   "DurationInYears":1,
   "Nameservers":[
      {
         "Name":"ns-2048.awsdns-64.com",
         "GlueIps":[
         "192.0.2.11"
         ]
      },
      {
         "Name":"ns-2049.awsdns-65.net",
         "GlueIps":[
         "192.0.2.12"
         ]
      }
   ],
    "AuthCode":"a42qxjz1",
   "AutoRenew":true,
   "AdminContact":{
      "FirstName":"John",
      "MiddleName":"Richard",
      "LastName":"Doe",
      "ContactType":"PERSON",
      "OrganizationName":"",
      "AddressLine1":"123 Any Street",
      "AddressLine2":"",
      "City":"Any Town",
      "State":"WA",
      "CountryCode":"US",
      "ZipCode":"98101",
      "PhoneNumber":"+1.1234567890",
      "Email":"john@example.com",
      "Fax":"+1.1234567891"
   },
   "RegistrantContact":{
      "FirstName":"John",
      "MiddleName":"Richard",
      "LastName":"Doe",
      "ContactType":"PERSON",
      "OrganizationName":"",
      "AddressLine1":"123 Any Street",
      "AddressLine2":"",
      "City":"Any Town",
      "State":"WA",
      "CountryCode":"US",
      "ZipCode":"98101",
      "PhoneNumber":"+1.1234567890",
      "Email":"john@example.com",
      "Fax":"+1.1234567891"
   },
   "TechContact":{
      "FirstName":"John",
      "MiddleName":"Richard",
      "LastName":"Doe",
      "ContactType":"PERSON",
      "OrganizationName":"",
      "AddressLine1":"123 Any Street",
      "AddressLine2":"",
      "City":"Any Town",
      "State":"WA",
      "CountryCode":"US",
      "ZipCode":"98101",
      "PhoneNumber":"+1.1234567890",
      "Email":"john@example.com",
      "Fax":"+1.1234567891"
   },
   "PrivacyProtectAdminContact":true,
   "PrivacyProtectRegistrantContact":true,
   "PrivacyProtectTechContact":true,
}
```

#### Sample Response
<a name="API_domains_TransferDomain_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
"OperationId":"308c56712-faa4-40fe-94c8-b423069de3f6"
}
```

## See Also
<a name="API_domains_TransferDomain_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/TransferDomain) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/TransferDomain) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/TransferDomain) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/TransferDomain) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/TransferDomain) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/TransferDomain) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/TransferDomain) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/TransferDomain) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/TransferDomain) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/TransferDomain) 

# TransferDomainToAnotherAwsAccount
<a name="API_domains_TransferDomainToAnotherAwsAccount"></a>

Transfers a domain from the current AWS account to another AWS account. Note the following:
+ The AWS account that you're transferring the domain to must accept the transfer. If the other account doesn't accept the transfer within 3 days, we cancel the transfer. See [AcceptDomainTransferFromAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_AcceptDomainTransferFromAnotherAwsAccount.html). 
+ You can cancel the transfer before the other account accepts it. See [CancelDomainTransferToAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_CancelDomainTransferToAnotherAwsAccount.html). 
+ The other account can reject the transfer. See [RejectDomainTransferFromAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_RejectDomainTransferFromAnotherAwsAccount.html). 

**Important**  
When you transfer a domain from one AWS account to another, Route 53 doesn't transfer the hosted zone that is associated with the domain. DNS resolution isn't affected if the domain and the hosted zone are owned by separate accounts, so transferring the hosted zone is optional. For information about transferring the hosted zone to another AWS account, see [Migrating a Hosted Zone to a Different AWS Account](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zones-migrating.html) in the *Amazon Route 53 Developer Guide*.

Use either [ListOperations](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ListOperations.html) or [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html) to determine whether the operation succeeded. [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html) provides additional information, for example, `Domain Transfer from Aws Account 111122223333 has been cancelled`. 

## Request Syntax
<a name="API_domains_TransferDomainToAnotherAwsAccount_RequestSyntax"></a>

```
{
   "AccountId": "string",
   "DomainName": "string"
}
```

## Request Parameters
<a name="API_domains_TransferDomainToAnotherAwsAccount_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [AccountId](#API_domains_TransferDomainToAnotherAwsAccount_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomainToAnotherAwsAccount-request-AccountId"></a>
The account ID of the AWS account that you want to transfer the domain to, for example, `111122223333`.  
Type: String  
Length Constraints: Fixed length of 12.  
Pattern: `^(\d{12})$`   
Required: Yes

 ** [DomainName](#API_domains_TransferDomainToAnotherAwsAccount_RequestSyntax) **   <a name="Route53Domains-domains_TransferDomainToAnotherAwsAccount-request-DomainName"></a>
The name of the domain that you want to transfer from the current AWS account to another account.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_domains_TransferDomainToAnotherAwsAccount_ResponseSyntax"></a>

```
{
   "OperationId": "string",
   "Password": "string"
}
```

## Response Elements
<a name="API_domains_TransferDomainToAnotherAwsAccount_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_TransferDomainToAnotherAwsAccount_ResponseSyntax) **   <a name="Route53Domains-domains_TransferDomainToAnotherAwsAccount-response-OperationId"></a>
Identifier for tracking the progress of the request. To query the operation status, use [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html).  
Type: String  
Length Constraints: Maximum length of 255.

 ** [Password](#API_domains_TransferDomainToAnotherAwsAccount_ResponseSyntax) **   <a name="Route53Domains-domains_TransferDomainToAnotherAwsAccount-response-Password"></a>
To finish transferring a domain to another AWS account, the account that the domain is being transferred to must submit an [AcceptDomainTransferFromAnotherAwsAccount](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_AcceptDomainTransferFromAnotherAwsAccount.html) request. The request must include the value of the `Password` element that was returned in the `TransferDomainToAnotherAwsAccount` response.  
Type: String

## Errors
<a name="API_domains_TransferDomainToAnotherAwsAccount_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_TransferDomainToAnotherAwsAccount_Examples"></a>

### TransferDomainToAnotherAwsAccount Example
<a name="API_domains_TransferDomainToAnotherAwsAccount_Example_1"></a>

This example illustrates one usage of TransferDomainToAnotherAwsAccount.

#### Sample Request
<a name="API_domains_TransferDomainToAnotherAwsAccount_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20200311T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.TransferDomainToAnotherAwsAccount
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
    "DomainName":"example.com",
    "AccountId":"111122223333"
}
```

#### Sample Response
<a name="API_domains_TransferDomainToAnotherAwsAccount_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
    "OperationId":"308c56712-faa4-40fe-94c8-b4230example",
    "Password":"CeT2Zxs~Example"
}
```

## See Also
<a name="API_domains_TransferDomainToAnotherAwsAccount_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/TransferDomainToAnotherAwsAccount) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/TransferDomainToAnotherAwsAccount) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/TransferDomainToAnotherAwsAccount) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/TransferDomainToAnotherAwsAccount) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/TransferDomainToAnotherAwsAccount) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/TransferDomainToAnotherAwsAccount) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/TransferDomainToAnotherAwsAccount) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/TransferDomainToAnotherAwsAccount) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/TransferDomainToAnotherAwsAccount) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/TransferDomainToAnotherAwsAccount) 

# UpdateDomainContact
<a name="API_domains_UpdateDomainContact"></a>

This operation updates the contact information for a particular domain. You must specify information for at least one contact: registrant, administrator, or technical.

If the update is successful, this method returns an operation ID that you can use to track the progress and completion of the operation. If the request is not completed successfully, the domain registrant will be notified by email.

## Request Syntax
<a name="API_domains_UpdateDomainContact_RequestSyntax"></a>

```
{
   "AdminContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "BillingContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "Consent": { 
      "Currency": "string",
      "MaxPrice": number
   },
   "DomainName": "string",
   "RegistrantContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "TechContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   }
}
```

## Request Parameters
<a name="API_domains_UpdateDomainContact_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [AdminContact](#API_domains_UpdateDomainContact_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainContact-request-AdminContact"></a>
Provides detailed contact information.  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: No

 ** [BillingContact](#API_domains_UpdateDomainContact_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainContact-request-BillingContact"></a>
Provides detailed contact information.  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: No

 ** [Consent](#API_domains_UpdateDomainContact_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainContact-request-Consent"></a>
 Customer's consent for the owner change request. Required if the domain is not free (consent price is more than \$10.00).  
Type: [Consent](API_domains_Consent.md) object  
Required: No

 ** [DomainName](#API_domains_UpdateDomainContact_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainContact-request-DomainName"></a>
The name of the domain that you want to update contact information for.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [RegistrantContact](#API_domains_UpdateDomainContact_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainContact-request-RegistrantContact"></a>
Provides detailed contact information.  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: No

 ** [TechContact](#API_domains_UpdateDomainContact_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainContact-request-TechContact"></a>
Provides detailed contact information.  
Type: [ContactDetail](API_domains_ContactDetail.md) object  
Required: No

## Response Syntax
<a name="API_domains_UpdateDomainContact_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_UpdateDomainContact_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_UpdateDomainContact_ResponseSyntax) **   <a name="Route53Domains-domains_UpdateDomainContact-response-OperationId"></a>
Identifier for tracking the progress of the request. To query the operation status, use [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html).  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_UpdateDomainContact_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_UpdateDomainContact_Examples"></a>

### UpdateDomainContact Example
<a name="API_domains_UpdateDomainContact_Example_1"></a>

This example illustrates one usage of UpdateDomainContact.

#### Sample Request
<a name="API_domains_UpdateDomainContact_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.UpdateDomainContact
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com",
   "RegistrantContact":{
      "FirstName":"John",
      "MiddleName":"Richard",
      "LastName":"Doe",
      "ContactType":"PERSON",
      "OrganizationName":"",
      "AddressLine1":"123 Any Street",
      "AddressLine2":"",
      "City":"Any Town",
      "State":"WA",
      "CountryCode":"US",
      "ZipCode":"98101",
      "PhoneNumber":"+1.1234567890",
      "Email":"john@example.com",
      "Fax":"+1.1234567891"
      },
   "AdminContact":{
      "FirstName":"John",
      "MiddleName":"Richard",
      "LastName":"Doe",
      "ContactType":"PERSON",
      "OrganizationName":"",
      "AddressLine1":"123 Any Street",
      "AddressLine2":"",
      "City":"Any Town",
      "State":"WA",
      "CountryCode":"US",
      "ZipCode":"98101",
      "PhoneNumber":"+1.1234567890",
      "Email":"john@example.com",
      "Fax":"+1.1234567891"
   },
   "TechContact":{
      "FirstName":"John",
      "MiddleName":"Richard",
      "LastName":"Doe",
      "ContactType":"PERSON",
      "OrganizationName":"",
      "AddressLine1":"123 Any Street",
      "AddressLine2":"",
      "City":"Any Town",
      "State":"WA",
      "CountryCode":"US",
      "ZipCode":"98101",
      "PhoneNumber":"+1.1234567890",
      "Email":"john@example.com",
      "Fax":"+1.1234567891"
   },
}
```

#### Sample Response
<a name="API_domains_UpdateDomainContact_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
"OperationId":"308c56712-faa4-40fe-94c8-b423069de3f6"
}
```

## See Also
<a name="API_domains_UpdateDomainContact_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/UpdateDomainContact) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/UpdateDomainContact) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/UpdateDomainContact) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/UpdateDomainContact) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/UpdateDomainContact) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/UpdateDomainContact) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/UpdateDomainContact) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/UpdateDomainContact) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/UpdateDomainContact) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/UpdateDomainContact) 

# UpdateDomainContactPrivacy
<a name="API_domains_UpdateDomainContactPrivacy"></a>

This operation updates the specified domain contact's privacy setting. When privacy protection is enabled, your contact information is replaced with contact information for the registrar or with the phrase "REDACTED FOR PRIVACY", or "On behalf of <domain name> owner."

**Note**  
While some domains may allow different privacy settings per contact, we recommend specifying the same privacy setting for all contacts.

This operation affects only the contact information for the specified contact type (administrative, registrant, or technical). If the request succeeds, Amazon Route 53 returns an operation ID that you can use with [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html) to track the progress and completion of the action. If the request doesn't complete successfully, the domain registrant will be notified by email.

**Important**  
By disabling the privacy service via API, you consent to the publication of the contact information provided for this domain via the public WHOIS database. You certify that you are the registrant of this domain name and have the authority to make this decision. You may withdraw your consent at any time by enabling privacy protection using either `UpdateDomainContactPrivacy` or the Route 53 console. Enabling privacy protection removes the contact information provided for this domain from the WHOIS database. For more information on our privacy practices, see [https://aws.amazon.com/privacy/](https://aws.amazon.com/privacy/).

## Request Syntax
<a name="API_domains_UpdateDomainContactPrivacy_RequestSyntax"></a>

```
{
   "AdminPrivacy": boolean,
   "BillingPrivacy": boolean,
   "DomainName": "string",
   "RegistrantPrivacy": boolean,
   "TechPrivacy": boolean
}
```

## Request Parameters
<a name="API_domains_UpdateDomainContactPrivacy_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [AdminPrivacy](#API_domains_UpdateDomainContactPrivacy_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainContactPrivacy-request-AdminPrivacy"></a>
Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify `false`, WHOIS queries return the information that you entered for the admin contact.  
You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.
Type: Boolean  
Required: No

 ** [BillingPrivacy](#API_domains_UpdateDomainContactPrivacy_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainContactPrivacy-request-BillingPrivacy"></a>
 Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify `false`, WHOIS queries return the information that you entered for the billing contact.   
You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.
Type: Boolean  
Required: No

 ** [DomainName](#API_domains_UpdateDomainContactPrivacy_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainContactPrivacy-request-DomainName"></a>
The name of the domain that you want to update the privacy setting for.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [RegistrantPrivacy](#API_domains_UpdateDomainContactPrivacy_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainContactPrivacy-request-RegistrantPrivacy"></a>
Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify `false`, WHOIS queries return the information that you entered for the registrant contact (domain owner).  
You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.
Type: Boolean  
Required: No

 ** [TechPrivacy](#API_domains_UpdateDomainContactPrivacy_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainContactPrivacy-request-TechPrivacy"></a>
Whether you want to conceal contact information from WHOIS queries. If you specify `true`, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify `false`, WHOIS queries return the information that you entered for the technical contact.  
You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.
Type: Boolean  
Required: No

## Response Syntax
<a name="API_domains_UpdateDomainContactPrivacy_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_UpdateDomainContactPrivacy_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_UpdateDomainContactPrivacy_ResponseSyntax) **   <a name="Route53Domains-domains_UpdateDomainContactPrivacy-response-OperationId"></a>
Identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_UpdateDomainContactPrivacy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_UpdateDomainContactPrivacy_Examples"></a>

### UpdateDomainContactPrivacy Example
<a name="API_domains_UpdateDomainContactPrivacy_Example_1"></a>

This example illustrates one usage of UpdateDomainContactPrivacy.

#### Sample Request
<a name="API_domains_UpdateDomainContactPrivacy_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.UpdateDomainContactPrivacy
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
"DomainName":"example.com",
"AdminPrivacy":true,
"RegistrantPrivacy":true,
"TechPrivacy":true,
}
```

#### Sample Response
<a name="API_domains_UpdateDomainContactPrivacy_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
"OperationId":"777bc5da-fbf7-482c-b2ba-8946884a7dd6"
}
```

## See Also
<a name="API_domains_UpdateDomainContactPrivacy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/UpdateDomainContactPrivacy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/UpdateDomainContactPrivacy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/UpdateDomainContactPrivacy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/UpdateDomainContactPrivacy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/UpdateDomainContactPrivacy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/UpdateDomainContactPrivacy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/UpdateDomainContactPrivacy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/UpdateDomainContactPrivacy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/UpdateDomainContactPrivacy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/UpdateDomainContactPrivacy) 

# UpdateDomainNameservers
<a name="API_domains_UpdateDomainNameservers"></a>

This operation replaces the current set of name servers for the domain with the specified set of name servers. If you use Amazon Route 53 as your DNS service, specify the four name servers in the delegation set for the hosted zone for the domain.

If successful, this operation returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

## Request Syntax
<a name="API_domains_UpdateDomainNameservers_RequestSyntax"></a>

```
{
   "DomainName": "string",
   "FIAuthKey": "string",
   "Nameservers": [ 
      { 
         "GlueIps": [ "string" ],
         "Name": "string"
      }
   ]
}
```

## Request Parameters
<a name="API_domains_UpdateDomainNameservers_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_UpdateDomainNameservers_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainNameservers-request-DomainName"></a>
The name of the domain that you want to change name servers for.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [FIAuthKey](#API_domains_UpdateDomainNameservers_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainNameservers-request-FIAuthKey"></a>
 *This parameter has been deprecated.*   
The authorization key for .fi domains  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 255.  
Required: No

 ** [Nameservers](#API_domains_UpdateDomainNameservers_RequestSyntax) **   <a name="Route53Domains-domains_UpdateDomainNameservers-request-Nameservers"></a>
A list of new name servers for the domain.  
Type: Array of [Nameserver](API_domains_Nameserver.md) objects  
Required: Yes

## Response Syntax
<a name="API_domains_UpdateDomainNameservers_ResponseSyntax"></a>

```
{
   "OperationId": "string"
}
```

## Response Elements
<a name="API_domains_UpdateDomainNameservers_ResponseElements"></a>

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

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

 ** [OperationId](#API_domains_UpdateDomainNameservers_ResponseSyntax) **   <a name="Route53Domains-domains_UpdateDomainNameservers-response-OperationId"></a>
Identifier for tracking the progress of the request. To query the operation status, use [GetOperationDetail](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html).  
Type: String  
Length Constraints: Maximum length of 255.

## Errors
<a name="API_domains_UpdateDomainNameservers_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DuplicateRequest **   
The request is already in progress for the domain.    
 ** message **   
The request is already in progress for the domain.  
 ** requestId **   
ID of the request operation.
HTTP Status Code: 400

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** TLDRulesViolation **   
The top-level domain does not support this operation.    
 ** message **   
The top-level domain does not support this operation.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_UpdateDomainNameservers_Examples"></a>

### UpdateDomainNameservers Example
<a name="API_domains_UpdateDomainNameservers_Example_1"></a>

This example illustrates one usage of UpdateDomainNameservers.

#### Sample Request
<a name="API_domains_UpdateDomainNameservers_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.UpdateDomainNameservers
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com",
   "Nameservers":[
      {
         "Name":"ns1.example.net"
      },
      {
         "Name":"ns1.example.com",
         "GlueIps":[
         "192.0.2.44"
         ]
      }
   ]
}
```

#### Sample Response
<a name="API_domains_UpdateDomainNameservers_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "OperationId":"0b370c79-faa4-40fe-94c8-b423069de3f6"
}
```

## See Also
<a name="API_domains_UpdateDomainNameservers_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/UpdateDomainNameservers) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/UpdateDomainNameservers) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/UpdateDomainNameservers) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/UpdateDomainNameservers) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/UpdateDomainNameservers) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/UpdateDomainNameservers) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/UpdateDomainNameservers) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/UpdateDomainNameservers) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/UpdateDomainNameservers) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/UpdateDomainNameservers) 

# UpdateTagsForDomain
<a name="API_domains_UpdateTagsForDomain"></a>

This operation adds or updates tags for a specified domain.

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

## Request Syntax
<a name="API_domains_UpdateTagsForDomain_RequestSyntax"></a>

```
{
   "DomainName": "string",
   "TagsToUpdate": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Request Parameters
<a name="API_domains_UpdateTagsForDomain_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [DomainName](#API_domains_UpdateTagsForDomain_RequestSyntax) **   <a name="Route53Domains-domains_UpdateTagsForDomain-request-DomainName"></a>
The domain for which you want to add or update tags.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** [TagsToUpdate](#API_domains_UpdateTagsForDomain_RequestSyntax) **   <a name="Route53Domains-domains_UpdateTagsForDomain-request-TagsToUpdate"></a>
A list of the tag keys and values that you want to add or update. If you specify a key that already exists, the corresponding value will be replaced.  
Type: Array of [Tag](API_domains_Tag.md) objects  
Required: No

## Response Elements
<a name="API_domains_UpdateTagsForDomain_ResponseElements"></a>

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

## Errors
<a name="API_domains_UpdateTagsForDomain_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

 ** OperationLimitExceeded **   
The number of operations or jobs running exceeded the allowed threshold for the account.    
 ** message **   
The number of operations or jobs running exceeded the allowed threshold for the account.
HTTP Status Code: 400

 ** UnsupportedTLD **   
Amazon Route 53 does not support this top-level domain (TLD).    
 ** message **   
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400

## Examples
<a name="API_domains_UpdateTagsForDomain_Examples"></a>

### UpdateTagsForDomain Example
<a name="API_domains_UpdateTagsForDomain_Example_1"></a>

This example illustrates one usage of UpdateTagsForDomain.

#### Sample Request
<a name="API_domains_UpdateTagsForDomain_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domain_v20140515.UpdateTagsForDomain
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName": "example.com",
   "TagsToUpdate":[
      {
         "Key": "foo",
         "Value": "bar"
      }, {
         "Key": "foo2",
         "Value": ""
      }
  ]
}
```

#### Sample Response
<a name="API_domains_UpdateTagsForDomain_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{}
```

## See Also
<a name="API_domains_UpdateTagsForDomain_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/UpdateTagsForDomain) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/UpdateTagsForDomain) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/UpdateTagsForDomain) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/UpdateTagsForDomain) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/UpdateTagsForDomain) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/UpdateTagsForDomain) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/UpdateTagsForDomain) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/UpdateTagsForDomain) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/UpdateTagsForDomain) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/UpdateTagsForDomain) 

# ViewBilling
<a name="API_domains_ViewBilling"></a>

Returns all the domain-related billing records for the current AWS account for a specified period

## Request Syntax
<a name="API_domains_ViewBilling_RequestSyntax"></a>

```
{
   "End": number,
   "Marker": "string",
   "MaxItems": number,
   "Start": number
}
```

## Request Parameters
<a name="API_domains_ViewBilling_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [End](#API_domains_ViewBilling_RequestSyntax) **   <a name="Route53Domains-domains_ViewBilling-request-End"></a>
The end date and time for the time period for which you want a list of billing records. Specify the date and time in Unix time format and Coordinated Universal time (UTC).  
Type: Timestamp  
Required: No

 ** [Marker](#API_domains_ViewBilling_RequestSyntax) **   <a name="Route53Domains-domains_ViewBilling-request-Marker"></a>
For an initial request for a list of billing records, omit this element. If the number of billing records that are associated with the current AWS account during the specified period is greater than the value that you specified for `MaxItems`, you can use `Marker` to return additional billing records. Get the value of `NextPageMarker` from the previous response, and submit another request that includes the value of `NextPageMarker` in the `Marker` element.   
Constraints: The marker must match the value of `NextPageMarker` that was returned in the previous response.  
Type: String  
Length Constraints: Maximum length of 4096.  
Required: No

 ** [MaxItems](#API_domains_ViewBilling_RequestSyntax) **   <a name="Route53Domains-domains_ViewBilling-request-MaxItems"></a>
The number of billing records to be returned.  
Default: 20  
Type: Integer  
Valid Range: Maximum value of 100.  
Required: No

 ** [Start](#API_domains_ViewBilling_RequestSyntax) **   <a name="Route53Domains-domains_ViewBilling-request-Start"></a>
The beginning date and time for the time period for which you want a list of billing records. Specify the date and time in Unix time format and Coordinated Universal time (UTC).  
Type: Timestamp  
Required: No

## Response Syntax
<a name="API_domains_ViewBilling_ResponseSyntax"></a>

```
{
   "BillingRecords": [ 
      { 
         "BillDate": number,
         "DomainName": "string",
         "InvoiceId": "string",
         "Operation": "string",
         "Price": number
      }
   ],
   "NextPageMarker": "string"
}
```

## Response Elements
<a name="API_domains_ViewBilling_ResponseElements"></a>

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

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

 ** [BillingRecords](#API_domains_ViewBilling_ResponseSyntax) **   <a name="Route53Domains-domains_ViewBilling-response-BillingRecords"></a>
A summary of billing records.  
Type: Array of [BillingRecord](API_domains_BillingRecord.md) objects

 ** [NextPageMarker](#API_domains_ViewBilling_ResponseSyntax) **   <a name="Route53Domains-domains_ViewBilling-response-NextPageMarker"></a>
If there are more billing records than you specified for `MaxItems` in the request, submit another request and include the value of `NextPageMarker` in the value of `Marker`.  
Type: String  
Length Constraints: Maximum length of 4096.

## Errors
<a name="API_domains_ViewBilling_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidInput **   
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.    
 ** message **   
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400

## Examples
<a name="API_domains_ViewBilling_Examples"></a>

### ViewBilling Example
<a name="API_domains_ViewBilling_Example_1"></a>

This example illustrates one usage of ViewBilling.

#### Sample Request
<a name="API_domains_ViewBilling_Example_1_Request"></a>

```
POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.ViewBilling
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
    "Start": 1461006299,
    "End": 1463598304,
    "MaxItems": 20
}
```

#### Sample Response
<a name="API_domains_ViewBilling_Example_1_Response"></a>

```
HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
    "BillingRecords": [
        {
            "BillDate": 1431211111, 
            "DomainName": "example.net", 
            "InvoiceId": "1111111111", 
            "Operation": "REGISTER_DOMAIN", 
            "Price": 12
        }, {
            "BillDate": 1431222222, 
            "DomainName": "example.com", 
            "InvoiceId": "2222222222", 
            "Operation": "TRANSFER_IN_DOMAIN", 
            "Price": 12
        }, {
            "BillDate": 1431233333, 
            "DomainName": "example.org", 
            "InvoiceId": "3333333333", 
            "Operation": "RENEW_DOMAIN", 
            "Price": 12
        }
    ]
}
```

## See Also
<a name="API_domains_ViewBilling_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/route53domains-2014-05-15/ViewBilling) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/route53domains-2014-05-15/ViewBilling) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/route53domains-2014-05-15/ViewBilling) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/route53domains-2014-05-15/ViewBilling) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ViewBilling) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/route53domains-2014-05-15/ViewBilling) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/route53domains-2014-05-15/ViewBilling) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/route53domains-2014-05-15/ViewBilling) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/route53domains-2014-05-15/ViewBilling) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/route53domains-2014-05-15/ViewBilling)