Getting Detailed Information About a Contact
Synopsis
| Description | A command to retrieve information about a contact object. |
| 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 ID (eg H12345) |
| password | Your Toolkit Password |
| handle | The Contact ID |
This command can be used to retrieve information about a contact object for which you are the sponsor. You are the sponsor of a contact object 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 the sponsoring registrar.
This command can also be used to retrieve contact information about a registrar, for use during a transfer.
To retrieve the details of a contact object, use the handle parameter to specify the ID of the contact object 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 contact object's details are show in WHOIS records for domains with which it is associated.
If the contact object 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 contact object, you will see an error like this:
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 1 Message: Permission denied.