FLfloqer
ackDB

Fuzzy contact search → the single closest contact (cross-entity)

The contact analog of /entities/search. Pick a field and send a value — per-field params (all ANDed): q (across all fields), name, email, phone, title, department, linkedin; at least one required. Ranked case-insensitive substring (exact > prefix > contains) selects the single closest active contact across all companies by default. Set includeFormer=true to include ended affiliations too; active wins an equal-score tie and disabled contacts never qualify. Returns the contact hydrated with its identity links, traits, and a compact company ref (entity: { entityId, name, domain }), plus a sibling matchedOn block. No match → 404.

get/api/v1/ackdb/contacts/search

Request

  • Base URL
    http://localhost:3009
  • Auth
    HTTP bearer

Query parameters

qstring

Match across all searchable fields (name/email/phone/title/department/linkedin).

namestring

Match the contact name.

emailstring

Match the contact email.

phonestring

Match the contact phone.

titlestring

Match the job title.

departmentstring

Match the department.

linkedinstring

Match the LinkedIn URL.

includeFormerboolean

Include former (ended) affiliations in addition to active contacts. Disabled contacts remain excluded; active wins an equal-score tie. Defaults to false.

Response

The closest contact (incl. personId) + its identityLinks, traits, a compact company entity ref, and a person block naming the human plus their OTHER affiliations (otherAffiliationCount, otherAffiliations[] — including ended stints: a job change is the signal), alongside a sibling matchedOn { field, value, tier }.

dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.