Getting Detailed Information About a Handle
Synopsis
| Description: | A command to retrieve information about a handle. |
| URL: | https://toolkit.centralnic.com/srv/handle_info |
| HTTP Method: | POST |
| Requires Authentication?: | Yes |
| Requires SSL?: | Yes |
| Query Parameters: | |
| test | The test flag (eg 1 or 0, optional) |
| user | Your Registrar Handle ID |
| password | Your encrypted Registrar password |
| handle | The Handle ID |
This command can be used to retrieve information about a handle for which you are the sponsor. You are the sponsor of a handle if you created it as part of a domain registration or modification process, or it is associated with a domain name for which you are Billing Handle.
This command can also be used to retrieve contact information about a registrar, for use during a transfer.
To retrieve the details of a handle, use the handle parameter to specify the ID of the handle in question.
Response Format
The output from this command looks like this:
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 0 Message: Handle details follow. name: John Doe company: Example Company Ltd address: 123 Example Street, London, England street1: 123 Example Street street2: street3: city: London sp: England postcode: NL6 4PQ country: UK phone: 020 7123 4567 fax: 020 7123 4568 email: domains@example.uk.com visible: 1
The above output contains both an address field for old-style "flat" address data, and the separate street, city and sp (state/province) fields for new-style addresses. The value of the address is always a flattened version of the individual address fields. If available, the new-style address fields should always be preferred over the address field.
The visible value is a binary value (1 or 0) that indicates whether this handle's details are show in WHOIS records for domains with which it is associated.
If the handle cannot be found, you will see an error like this:
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 1 Message: Handle 'H12345' not found.
If you are not the sponsor of the handle, you will see an error like this:
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 1 Message: Permission denied.