Bulk Email Finder API

Email Finder now accepts asynchronous batches of up to 1,000 contacts and returns explicit found, not-found, and row-level error statuses.

Email Finder now supports asynchronous batches of up to 1,000 contacts, replacing client-side loops with a submit-and-poll workflow.

What changed

  • Submit a batch with POST /v1/contacts/find-email/batch and poll its progress with GET /v1/contacts/find-email/batch/{id}.
  • Read per-contact found, not_found, or error outcomes as rows complete.
  • Receive partial results even when one domain or contact cannot be resolved.
  • Rely on server-side domain grouping, pacing, and retries instead of implementing them in each client.
  • Single Email Finder responses now include an explicit found or not_found status.

Batch results are retained for 30 days.

Learn more

On this page