Check availability

Description

Checks if a domain name is free for registration.

Note: This function is not available for sub users.

 Parameters

Return: Array with domain name(s) and their status: 1 for available and 0 for unavailable.

Errors

When the authentication of API user is not correct, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}

If there is not added a domain name, the following status will be returned:

{"status":"Failed","statusDescription":"Missing domain name parameter"}

If there is not added any parameter for TLD, the following status will be returned:

{"status":"Failed","statusDescription":"Missing tld paramter"}

Note: These are example errors in JSON format.

 Example

URL JSON: https://api.cloudns.net/domains/check-available.json
POST/GET: auth-id=0&auth-password=password&name=domain&tld[]=com&tld[]=net

URL XML: https://api.cloudns.net/domains/check-available.xml
POST/GET: auth-id=0&auth-password=password&name=domain&tld[]=com&tld[]=net