Searching for Contacts


Gets the Contact Details of the Contacts that match the Search criteria.


Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
customer-id Integer Required The Customer for which you want to get the Contact Details
no-of-records Integer Required Number of Records to be returned
page-no Integer Required Page Number for which records are required
contact-id Array of Integers Optional Array of Contact Ids for listing of specific Contacts
status Array of Strings Optional List of Contact statuses. These can take any values from: InActive, Active, Suspended, Deleted
name String Optional Name of Contact
company String Optional Name of the Company
email String Optional Email address of the Contact
type String Optional Type of contact. Valid values are: Contact, CoopContact, UkContact, EuContact, Sponsor, CnContact, CoContact, CaContact, DeContact, EsContact.

HTTP Method


Example Test URL Request


Returns a hash map containing the below details of the Contacts that match the search criteria:

  • Number of Contacts requested matching the search criteria (recsonpage)

    Following details of each Contact:

    • Contact ID (entity.entityid)

    • Name (

    • Company (

    • Contact Type (contact.type)

    • Email Address (contact.emailaddr)

    • Telephone Number Country Code (contact.telnocc)

    • Telephone Number (contact.telno)

    • First line of address of the Contact (contact.address1)

    • Second line of address of the Contact (contact.address2)

    • Third line of address of the Contact (contact.address3)

    • City (

    • State (contact.state)

    • Country Code (

    • ZIP Code (

    • Current Status in the System (entity.currentstatus)

    • Creation Date in the System (contact.creationdt)

    • Creation Date at the Registry (contact.timestamp)

    • Customer ID associated with the Contact (entity.customerid)

    • Designated Agent Status (dastatus)

  • Number of Contacts in the System matching the search criteria (recsindb)

In case of any errors, a status key with value as ERROR alongwith an error message will be returned.


Unused Contacts (except Default Contacts) that were created more than six months ago are archived. This API call will not search for archived Contacts.

Additional Information

Default Contacts