Route53Domains / Client / check_domain_transferability

check_domain_transferability¶

Route53Domains.Client.check_domain_transferability(**kwargs)¶

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

Request Syntax

response = client.check_domain_transferability(
    DomainName='string',
    AuthCode='string'
)

Parameters:

DomainName (string) –
[REQUIRED]

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 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.
AuthCode (string) – 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.

Return type:

dict

Returns:

Response Syntax

{
    'Transferability': {
        'Transferable': 'TRANSFERABLE'|'UNTRANSFERABLE'|'DONT_KNOW'|'DOMAIN_IN_OWN_ACCOUNT'|'DOMAIN_IN_ANOTHER_ACCOUNT'|'PREMIUM_DOMAIN'|'PENDING'
    },
    'Message': 'string',
    'Price': {
        'Price': 123.0,
        'Currency': 'string',
        'PriceType': 'STANDARD'|'REGISTRY_PREMIUM'
    }
}

Response Structure

(dict) –

The CheckDomainTransferability response includes the following elements.
- Transferability (dict) –
  
  A complex type that contains information about whether the specified domain can be transferred to Route 53.
  - Transferable (string) –
    
    Whether the domain name can be transferred to Route 53.
    
    Note
    You can transfer only domains that have a value of TRANSFERABLE or Transferable.
    
    Valid values:
    
    TRANSFERABLE
    
    The domain name can be transferred to Route 53.
    
    UNTRANSFERRABLE
    
    The domain name can’t be transferred to Route 53.
    
    DONT_KNOW
    
    The TLD registry didn’t reply with a definitive answer about whether the domain name can be transferred. Route 53 can return this response for a variety of reasons, for example, the registry is performing maintenance. Try again later.
    
    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.
    
    DOMAIN_IN_OWN_ACCOUNT
    
    The domain already exists in the current Amazon Web Services account.
    
    DOMAIN_IN_ANOTHER_ACCOUNT
    
    The domain exists in another Amazon Web Services account.
    
    PREMIUM_DOMAIN
    
    Premium domain transfer is not supported.
- Message (string) –
  
  Provides an explanation for when a domain can’t be transferred.
- Price (dict) –
  
  The price to transfer the domain name to Route 53, in the currency that Currency specifies. If the domain has registry premium pricing, this price is different from the standard rate for the TLD that ListPrices returns. Use PriceType to determine which rate applies.
  
  This element is returned only when Route 53 can determine whether the domain is transferable.
  - Price (float) –
    
    The price of a domain, in a specific currency.
  - Currency (string) –
    
    The currency specifier.
  - PriceType (string) –
    
    Indicates whether the domain has standard or premium pricing. A value of STANDARD means the domain is priced at the regular rate for its TLD. A value of REGISTRY_PREMIUM means the domain has registry premium pricing, which may be different than the standard rate.

Exceptions

Route53Domains.Client.exceptions.InvalidInput
Route53Domains.Client.exceptions.UnsupportedTLD
Route53Domains.Client.exceptions.TLDInMaintenance