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

  • Domain renewal

  • Domain restoration

See also: AWS API Documentation

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'
            },
            'TransferPrice': {
                'Price': 123.0,
                'Currency': 'string'
            },
            'RenewalPrice': {
                'Price': 123.0,
                'Currency': 'string'
            },
            'ChangeOwnershipPrice': {
                'Price': 123.0,
                'Currency': 'string'
            },
            'RestorationPrice': {
                'Price': 123.0,
                'Currency': 'string'
            }
        },
    ],
    '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 domain price associated with a TLD.

        • Name (string) –

          The name of the TLD for which the prices apply.

        • 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.

        • 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.

        • 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.

        • ChangeOwnershipPrice (dict) –

          The price for changing domain ownership.

          • Price (float) –

            The price of a domain, in a specific currency.

          • Currency (string) –

            The currency specifier.

        • 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.

    • 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.

Exceptions

  • Route53Domains.Client.exceptions.InvalidInput

  • Route53Domains.Client.exceptions.UnsupportedTLD