Case Study - Global Reach, Local Touch: The Role of GeoDNS in eCommerce Expansion

Check availability

Description

Checks if a domain name is free for registration.

Note: This function is not available for sub users.


 Parameters

Name Data Type Status Description
auth-id Integer Required Authentication parameter
auth-password String Required Authentication parameter
name String Required Name of the domain
tld Array Required TLD of the domain

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


Last modified: 2020-01-13
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more