Route53Domains / Client / list_prices

list_prices¶

Route53Domains.Client.list_prices(**kwargs)¶

Lists the following prices for either all the TLDs supported by Route 53, or the specified TLD:

Registration
Transfer
Owner change
Renewal
Restoration

Note

The prices that ListPrices returns are the standard rates for a TLD. ListPrices doesn’t return registry premium prices, which apply to individual domain names rather than to a TLD. To get accurate pricing for a specific domain name, including premium prices, call GetDomainPrices.

Request Syntax

response = client.list_prices(
    Tld='string',
    Marker='string',
    MaxItems=123
)

Parameters:

Tld (string) –
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.
Marker (string) –
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.
MaxItems (integer) –
Number of Prices to be returned.

Used only for all TLDs. If you specify a TLD, don’t specify a MaxItems.

Return type:

dict

Returns:

Response Syntax

{
    'Prices': [
        {
            'Name': 'string',
            'RegistrationPrice': {
                'Price': 123.0,
                'Currency': 'string',
                'PriceType': 'STANDARD'|'REGISTRY_PREMIUM'
            },
            'TransferPrice': {
                'Price': 123.0,
                'Currency': 'string',
                'PriceType': 'STANDARD'|'REGISTRY_PREMIUM'
            },
            'RenewalPrice': {
                'Price': 123.0,
                'Currency': 'string',
                'PriceType': 'STANDARD'|'REGISTRY_PREMIUM'
            },
            'ChangeOwnershipPrice': {
                'Price': 123.0,
                'Currency': 'string',
                'PriceType': 'STANDARD'|'REGISTRY_PREMIUM'
            },
            'RestorationPrice': {
                'Price': 123.0,
                'Currency': 'string',
                'PriceType': 'STANDARD'|'REGISTRY_PREMIUM'
            }
        },
    ],
    'NextPageMarker': 'string'
}

Response Structure

(dict) –
- Prices (list) –
  
  A complex type that includes all the pricing information. If you specify a TLD, this array contains only the pricing for that TLD.
  - (dict) –
    
    Information about the prices associated with a TLD or a domain name.
    - Name (string) –
      
      The TLD or domain name that the prices apply to.
    - RegistrationPrice (dict) –
      
      The price for domain registration with Route 53.
      - 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.
    - TransferPrice (dict) –
      
      The price for transferring the domain registration to Route 53.
      - 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.
    - RenewalPrice (dict) –
      
      The price for renewing domain registration with Route 53.
      - 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.
    - ChangeOwnershipPrice (dict) –
      
      The price for changing domain ownership.
      - 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.
    - RestorationPrice (dict) –
      
      The price for restoring the domain with Route 53.
      - 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.
- NextPageMarker (string) –
  
  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.