Doing a Domain Availability Search
Synopsis
| Description: | A command to search for the availability of a domain name across multiple suffixes. |
| URL: | http://toolkit.centralnic.com/srv/search |
| HTTP Method: | GET |
| Requires Authentication?: | No |
| Requires SSL?: | No |
| Query Parameters: | |
| test | The test flag (eg 1 or 0, optional) |
| domain | The domain prefix (eg "example") |
| suffixlist | A comma-separated list of domain suffixes (optional) |
This command can be used to do a very fast domain availability check against one or more of our suffixes. You can specify any number of domain suffixes to use, or omit the suffixlist parameter altogether, and search against all suffixes.
Response Format
The output from this command looks like this:
Status: 0 Message: domain search completed ok example.uk.com: 1::"Example Company Ltd"::982281600 example.uk.net: 1::"Example Company Ltd"::982281600 example.gb.com: 0 example.gb.net: 0
Each line has a simple Name: value format, with additional data in the value field delimited by a double colon ("::"), and enclosed by quotes.
The first line contains the status of the query: 1 for an error, 0 for successful query. The second line may contain an optional error message.
A registered domain will have a data field of the form
1::Registrant::ExpiryDate
The expirydate is in seconds since the UNIX epoch. An available domain will have a data field containing a zero ("0").