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:

Use 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↓

curl -X GET \
 'https://api.openprovider.eu/v1beta/domains/prices?domain.name==example&domain.extension=com&operation=create&period=1' \
 -H 'Authorization: Bearer 677428a4de6e0********0aa0225a1fa'

RESPONSE EXAMPLE↓

{
"code": 0,
"desc": "",
"data": {
"price": {
"product": {
"price": 9.77,
"currency": "USD"
},
"reseller": {
"price": 9.77,
"currency": "USD"
}
},
"is_premium": false,
"is_promotion": false,
"tier_price": {
"product": {
"price": 10.52
,"currency": "USD"
},
"reseller": {
"price": 10.52
,"currency": "USD"
}
}
}
}

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

REQUEST VALUES↓

Name

Type

Values

Description