3 Domains API: How to retrieve domain price

This is a series of articles dedicated to demonstrating how to get acquainted with Openprovider Domains API methods.

This is the second article in a series in which we are going to cover Domain price retrieval. To get more information about our API in general, please use our documentation portal as your reference.

Once you've ensured that the domain you want to register is free with checkDomainRequest described in our previous article, you're ready to move forward.
Pick the domain registration period and retrieve its price using the API call described below:
Entering Geo Fence iconUse the endpoint path below. The base URL is determined by both the target environment and the API version.
 GET {base_url}/domains/prices

REQUEST VALUES

Name

Type

Values

Description

domain.name  string Any domain name

Required

 Domain name for which you're retrieving price

domain.extension string Any extension offered by Openprovider

Required

 Domain extension for which you're retrieving price

additional_data.idn_script  string

The idn script states what language or character set the domain name is in Applicable to: .actor, .ae.org, .airforce, .army, .art, .attorney, .auction, .band, .bar, .best, .br.com, .ceo, .cn.com, .college, .com, .com.de, .com.se, .consulting, .dance, .de.com, .degree, .democrat, .dentist, .design, .engineer, .eu.com, .eus, .feedback, .fm, .forsale, .frl, .fun, .futbol, .gal, .gb.net, .gives, .gr.com, .haus, .hiv, .host, .immobilien, .in.net, .info, .ink, .jp.net, .jpn.com, .kaufen, .kyoto, .lawyer, .love, .market, .me, .mex.com, .moda, .mortgage, .navy, .net, .ninja, .nrw, .online, .ooo, .org, .press, .protection, .pub, .pw, .quebec, .radio.am, .radio.fm, .realty, .rehab, .rent, .republican, .rest, .reviews, .rip, .rocks, .ru.com, .sa.com, .scot, .se.net, .security, .site, .social, .software, .space, .store, .tech, .theatre, .tickets, .top, .uk.com, .uk.net, .us.com, .us.org, .vet, .website, .wiki, .xn--4gbrim, .xn--55qx5d, .xn--5tzm5g, .xn--80asehdb, .xn--80aswg, .xn--c1avg, .xn--czru2d, .xn--i1b6b1a6a2e, .xn--io0a7i, .xn--mk1bu44c, .xn--ngbc5azd, .xn--nqv7f, .xn--t60b56a, .xn--tckwe, .xyz, .za.com.

 Required for checking domain names containing non-ASCII characters

 operation  string
  • create (default)
  • transfer
  • renew
  • restore
  • trade
  • update

  Type of domain operation you'd like to retrieve price for

 period  numeric  1(default) - 10

Any registration period applicable for the extension. Used in conjunction with create operation only.

REQUEST EXAMPLE

RESPONSE EXAMPLE

RESPONSE VALUES

Name

Type

Values

Description

 price

 string

 array of elements

 Amounts in product and reseller currency

is_premium  boolean  true or false Indicates whether a domain is premium and has a higher than standard price or not.
is_promotion
boolean true or false Indicates whether any promotion is applicable

TIP: It's a best practice to retrieve the domain price before any billable operation you're about to commit - there are many elements involved in domain price calculation, ranging from currency conversion rates to your personal discounts and promotions. The price you've retrieved today may differ from the one you retrieved yesterday.

Using this API call various extensions and registration periods can be checked and compared, to pick the combination of price and extension that meets your and your customer's demands.
Once you've made up your mind, let's move on and learn about registration requirements
Was this article helpful?
Additional questions? Submit a request