ListPrices
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
{
"Marker": "string
",
"MaxItems": number
,
"Tld": "string
"
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- Marker
-
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 useMarker
to return additional prices. Get the value ofNextPageMarker
from the previous response, and submit another request that includes the value ofNextPageMarker
in theMarker
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
-
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
-
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
{
"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
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
-
If there are more prices than you specified for
MaxItems
in the request, submit another request and include the value ofNextPageMarker
in the value ofMarker
.Used only for all TLDs. If you specify a TLD, don't specify a
NextPageMarker
.Type: String
Length Constraints: Maximum length of 4096.
- Prices
-
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 objects
Errors
For information about the errors that are common to all actions, see Common Errors.
- 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.HTTP Status Code: 400
- UnsupportedTLD
-
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: