Search contacts | Distru Documentation

Searches the contacts of the caller's company — the people it deals with at its customers, vendors and its own company.

Inputs

Every tool also takes the common inputs.

Field	Type	Required	Description
limit	integer	No	Default: `10`
cursor	string	No	nextCursor of the previous call; keep the other arguments unchanged.
companyIds	string[]	No	Resolve via distru-search-companies.
customFields	object[]	No	Set one of contains, anyOf or onOrAfter/onOrBefore per entry. Records with no value for the field never match.
customFields[].customFieldId	string	Yes	Resolve via distru-search-custom-fields.
customFields[].contains	string	No	TEXT: case-insensitive substring.
customFields[].anyOf	string[]	No	DROPDOWN, CHECKBOX: any of these options, case-sensitive.
customFields[].onOrAfter	string	No	DATE: YYYY-MM-DD, company timezone.
customFields[].onOrBefore	string	No	DATE: YYYY-MM-DD, company timezone.
ids	string[]	No
search	string	No	Case-insensitive substring of full name, company name or email. Unranked; sortBy applies.
sortBy	object	No	Default UPDATED_AT DESC.
sortBy.direction	enum `ASCDESC`	Yes
sortBy.field	enum `FULL_NAMEINSERTED_ATUPDATED_AT`	Yes

Output

Presence on a nested field assumes its parent exists.

Field	Type	Presence	Description
hasMore	boolean	Always
nextCursor	string	Can be absent
totalCount	integer	Can be absent
items	object[]	Always
items[].id	string	Always
items[].firstName	string	Always
items[].lastName	string	Null or absent
items[].title	string	Null or absent
items[].description	string	Null or absent
items[].email	string	Null or absent
items[].phone	string	Null or absent
items[].workPhone	string	Null or absent
items[].owner	object	Null or absent
items[].owner.id	string	Always
items[].owner.fullName	string	Null or absent
items[].driverLicenseNumber	string	Null or absent
items[].driverLicenseIssuingState	string	Null or absent
items[].customFields	object[]	Always
items[].customFields[].customField	object	Always
items[].customFields[].customField.id	string	Always
items[].customFields[].customField.name	string	Always
items[].customFields[].customField.fieldType	enum `CHECKBOXDATEDROPDOWNTEXT`	Always
items[].customFields[].value	string	Can be null	Null when unset. DATE values are days (YYYY-MM-DD) in the company timezone; CHECKBOX values are the selected option names, separated by commas.
items[].company	object	Null or absent
items[].company.id	string	Always
items[].company.name	string	Null or absent
items[].insertedAt	string	Always
items[].updatedAt	string	Always

What the AI reads

Searches the contacts of the caller's company — the people it deals with at its customers, vendors and its own company. Use it to find a person's email or phone, or who the contacts at a company are. owner is the Distru user responsible for the contact, not someone at the contact's company.