Description
Checks the availability of the specified domain name(s).
Parameters
Name | Data Type | Required / Optional | Description |
---|---|---|---|
auth-userid | Integer | Required | Authentication Parameter |
api-key | String | Required | Authentication Parameter |
domain-name | Array of Strings | Required | Domain name(s) that you need to check the availability for |
tlds | Array of Strings | Required | TLDs for which the domain name availability needs to be checked See details |
HTTP Method
GET
Example Test URL Request
https://domaincheck.httpapi.com/api/domains/available.json?auth-userid=0&api-key=key&domain-name=domain1&domain-name=domain2&tlds=com&tlds=net
Response
Returns a hash map containing domain name availability status for the requested TLDs:
-
Domain Availability Status (status)
-
available - domain name available for registration
-
regthroughus - domain name currently registered through the Registrar whose connection is being used to check the availability of the domain name
-
regthroughothers - domain name currently registered through a Registrar other than the one whose connection is being used to check the availability of the domain name. If you wish to manage such a domain name through your Reseller Account, you may pass a Domain Transfer API call. See details
-
unknown - returned, if for some reason, the Registry connections are not available. You should ideally re-check the domain name availability after some time.
Note
-
-
Trademark Claims Key (tm-claims-key) - will be returned only if the domain name is available and Trademark for that domain name is listed in the Trademark Clearinghouse database
-
Premium Names (costHash) - A hash map will be returned only if the domain is a premium name along with the pricing of the domain ("create", "renew", "transfer") and the selling currency symbol
-
Early Access Program (costHash) - A hash map will be returned only if the domain is in EAP along with the early access fee ("early_access_fee") and the selling currency symbol. The early access fee is the non-refundable component which needs to added to the selling price of the domain