live chat
24/7 Emergency Hotline USA

Domain Availability Check

Resource path: /Domain/Check

https://testapi.internet.bs/Domain/Check?ApiKey=testapi&Password=testpass&.......

The command is intended to check whether a domain is available for registration or not. The command is not generating any cost.
HTTPS POST/GET Request parameters:

Parameter name Description

ApiKey

The API key that we provided to you when you requested API access for your account

Password

The password we provided when you requested API access for your account

Domain

Domain name with extension.

ResponseFormat
(optional)

This specifies how the response will be returned. Possible values are TEXT, JSON and XML.
The default value is TEXT however we encourage you to use JSON for easier result parsing (please refer to http://www.json.org for more details about JSON).

Returned data:

TRANSACTID=Transaction ID reference
STATUS=AVAILABLE or UNAVAILABLE or FAILURE
Domain=domain name
Punycode=ASCII form of domain name (appear only for IDN domains)
MinRegPeriod=integer+(Y or M or D where Y is Years, M is months and D is days)
MaxRegPeriod=integer+(Y or M or D where Y is Years, M is months and D is days)
registrarLockAllowed=YES or NO
privateWhoisAllowed=YES or NO
realTimeRegistration=YES or NO

Example:

https://testapi.internet.bs/Domain/Check?Domain=example.com&ApiKey=testapi&Password=testpass

Result:

transactid=e504cdbf00e7821e954f0f5a65249ff0
status=UNAVAILABLE
domain=example.com
minregperiod=1Y
maxregperiod=10Y
registrarlockallowed=YES
privatewhoisallowed=YES
realtimeregistration=YES

In case of checking availability for an IDN domain the response will also have a new field punycode that will contain the ASCII form of the domain while the domain field will have the unicode name.

Example:

https://testapi.internet.bs/Domain/Check?ApiKey=testapi&Password=testpass&Domain=тираспол.net
OR
https://testapi.internet.bs/Domain/Check?ApiKey=testapi&Password=testpass&Domain=xn--80apkleeie.net

Result:

transactid=e870cdbf00e7821e954f0f5a62349ff0
status=UNAVAILABLE
domain=тираспол.com
punycode=xn--80apkleeie.com
minregperiod=1Y
maxregperiod=10Y
registrarlockallowed=YES
privatewhoisallowed=YES
realtimeregistration=YES

Possible errors

CodeSample error message
100004The domain {domain_name} has a not supported extension!

Note: generic error codes and messages please see here.