Loading...

Knowledge Base
Home 
 
/
 How to Check Premium Domain Status Using the API
Categories: Domains API

How to Check Premium Domain Status Using the API

When your system or integration needs to check premium domain status automatically. This article explains how to check premium domain status using the API.

Check if a Domain Name is Premium

 
  • Description
  • Parameters
  • HTTP Method
  • Example Test URL Request
  • Response
 
Description
This method can be used to identify if the domain name specified is a premium domain name along with its pricing details.
 
Parameters
Name
Data Type
Required / Optional
Description
auth-userid
Integer
Required
Your Live Account Reseller Id
api-key
String
Required
An alphanumeric code that can be used to authenticate your API calls
domain-name
String
Required
The domain name whose premium status is being checked
 
HTTP Method
GET
 
Example Test URL Request
https://test.httpapi.com/api/domains/premium-check.json?auth-userid=0&api-key=0&domain-name=name.tld
 
Response
Returns the premium status (premium) as true or false along with a hash map containing the customer's and reseller's pricing details as following:
  • premium - Status of the domain. "true" if the domain is premium.
  • costHash - Customer's pricing details.
  • transfer - Transfer price of the domain.
  • renew - Renewal price of the domain.
  • create - Registration price of the domain.
  • sellingCurrencySymbol - Selling currency of the reseller.
  • resellerCostPriceHash - Reseller's pricing details.