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 a 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 API call descried below:

Use endpoint path below. Base URL is determined by both the target environment and API version.

 GET {base_url}/domains/prices

REQUEST VALUES↓

Name	Type	Values	Description
domain	string	Any combination of domain name and extension offered by Openprovider	Required Domain and extension for which you're retrieving price
additional_data	string	idnScript is the only type of additionalData accepted in this API call. Values list	idnScript 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 this extension. Used in conjunction with create operation only.

REQUEST EXAMPLE↓

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

RESPONSE EXAMPLE↓

{
"code": 0,
"data": {
"is_premium": false,
"price": {
"product": {
"currency": "USD",
"price": 8.06
},
"reseller": {
"currency": "USD",
"price": 8.06
}
}
},
"desc": ""
}

RESPONSE VALUES↓

Name	Type	Values	Description
price	string	array of elements	Amounts in product and reseller currency
is_premium	boolean	0 or 1	Indicates, whether a domain is premium and has a higher than standard price or not.

TIP: It's a best practice to retrieve 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. Price you've retrieved today may differ from the one you've 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 meet yours 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