WhoAPI is a RESTful based API. Communication is made through a normal HTTP requests.
Requests are made as strings using HTTP GET method. All outputs are provided as a JSON formatted response.
Authentication is needed in order to use the API, and for this a WhoAPI account is required. You'll need your API key every time you make a request. You have the option to limit API requests by a certain IP addresses in your account settings.
You can find your unique API key inside the "My account" section on the left once you register.
WhoAPI consists of several different APIs. Complete list here. You can access (send requests) to any of our APIs, and upgrade the ones you plan to use. You can send requests to all APIs with the same API key.
Result is stored in the "taken" value which is in this case "1", same as "Domain not available for registration".
Each function has a set of its own resulting variables.
|1||Invalid characters in domain name.|
|2||Use of double dot in domain name.|
|3||Domain name starting or ending with dash or dot.|
|4||TLD does not exist.|
|5||Too many characters in domain name (without TLD), maximum length is 64.|
|6||Too many characters in TLD.|
|7||Whois server not yet supported. We are adding new servers on a weekly basis.|
|8||Missing request type in 'r' parameter.|
|9||Invalid request type in 'r' parameter.|
|10||API key invalid.|
|11||Invalid characters in 'port' parameter.|
|12||Invalid API account.|
|15||IP not whitelisted in Account settings.|
|16||Too many tries, your IP has been blocked for a minute.|
|17||Query limit exceeded.|
|18||Query high usage limit exceeded.|
|19||Missing domain name in 'domain' parameter.|
|20||Invalid IP address in 'ip' parameter.|
|21||Invalid 'fullurl' parameter, must be fully qualified URI.|
|22||Invalid node data, only numeric characters allowed.|
|23||Missing 'port' parameter.|
|24||Missing valid TLD in domain name.|
|25||Unknown output type.|
|26||Timeout getting the result from a node.|
|27||Fatal error detected in result from a node.|
|28||Unknown error detected in result from a node.|
|29||Cannot resolve domain name, IP needed.|
|30||Problem with the WHOIS server, please try again later.|
|31||WHOIS limit reached for used WhoAPI node. Please make a new request.|
|32||Cannot resolve domain availability by using the requested method.|