# Get Pricing For Domain

Retrieves the registration and renewal pricing for a given domain.

Endpoint: GET /core/v1/domains/{domainName}:getPricing
Version: 1.3.1
Security: BasicAuth

## Path parameters:

  - `domainName` (string, required)
    DomainName is the domain to retrieve.

## Query parameters:

  - `years` (integer)
    Years specifies the time period in years to get pricing for the domain. Years defaults to the minimum time period (typically 1 year) if not passed and cannot be more than 10.  Some TLDs default to longer periods (e.g. .AI requires 2 year periods).
    Example: 2

## Response 200 fields (application/json):

  - `premium` (boolean, required)
    Premium indicates that this pricing is a premium result and the respective prices must be passed in create, renew or transfer commands.

  - `purchasePrice` (number, required)
    PurchasePrice is the price you will pay to register a domain. Can be passed in the CreateDomain request.
    Example: 24.99

  - `renewalPrice` (number, required)
    RenewalPrice is the price you will pay to renew a domain. Can be passed in the RenewDomain request.
    Example: 24.99

  - `transferPrice` (number, required)
    TransferPrice is the price you will pay to transfer a domain. Can be passed in the CreateTransfer request. The TransferPrice is always for 1 year regardless of the years input.
    Example: 24.99

## Response 404 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "Not Found"

  - `details` (string,null)
    Additional context or information about the error
    Example: "The requested domain does not exist."

## Response 429 fields (application/json):

  - `message` (string)
    A human-readable message providing more details about the error
    Example: "Rate Limit Exceeded"