match_contacts

Bulk-resolve many contacts in ONE call by a known set of values — instead of looping get_contact N times. Supply filters of {field, values[], mode}: exact (IN, case-sensitive — for ids/emails) or contains (case-insensitive literal substring — for names/company; LIKE metacharacters are treated as literal text). Contains-eligible fields: email, first_name, last_name, company, job_title. Guest-geography filters with UK/US alias expansion belong on search_contacts (country / country_not / city), not here. Combine filters with 'any' (OR, default) or 'all' (AND). detail:'full' adds socials/phone plus batched recent notes (capped at 5/contact) and attached media for every match in one query-set (no N+1). Returns matches (each with matched_by reporting which supplied value hit it), unmatched (supplied values that hit nothing), and truncated. Caps: ≤50 values/filter, ≤5 filters, ≤200 summary rows / ≤50 full rows. Use this for reconciliation against a caller-supplied set — not for large scans (use search_contacts to browse/relevance-rank).