Probabilistic (fuzzy) identity match
Scores existing contacts against the supplied partial record using Jaro-Winkler field similarity and returns ranked candidates with a confidence score (0–1), a band (auto_merge | review), a per-field similarity breakdown, and a recommended action. Closes the deterministic-only gap: the identity graph keys on exact match_types (external_id / phone / email / anonymous_id), so two records of the same person that arrived with no shared exact key cannot be unified by rules alone. Supply at least one of email, phone, first_name, last_name, or company — an all-empty body is rejected. This surface is READ-ONLY: it scores and ranks, it never merges or mutates a contact. Owner / admin / developer with the contacts:read scope (the payload embeds contact PII).
Authorizations
Dashboard JWT token from Clerk
Body
3 - 254Accepts E.164 or display formats; normalized server-side.
3 - 641 - 2001 - 2001 - 200Max candidates returned (post-scoring).
1 <= x <= 50Confidence floor for the review band. Must be <= auto_merge_threshold.
0 <= x <= 1Confidence at/above which a candidate is banded auto_merge.
0 <= x <= 1