Triggers email finding for a previous People Search result set, using the trackId from the People Search API response. This is step 2 of the two-step list-building flow (search → find emails).

💳 Credit Usage: 1 credit per found valid email (0.5 for the people data + 0.5 for the real-time BounceBan-verified email) — and 0 credits for people where no valid email is found. Example: 25 people submitted, 18 valid emails found = 18 × 1 = 18 credits; the other 7 cost nothing. Unlike Export People with Email (0.5 per person regardless + 0.5 per found email), here you only pay for delivered emails.

✅ Email Verification: All emails (SMTP & CATCH_ALL) returned by the API are verified in real time by BounceBan — safe to send, no re-verification needed.

⚠️ Important: Each trackId can only be used once. After the first request, the track ID is consumed and subsequent requests with the same ID will fail. The trackId also expires 6 hours after the original People Search response.

Provide a webhook URL to receive asynchronous notifications when email finding completes. When the job completes, we POST the result to your webhook URL.

Auto-refund window: A submission that is charged but never delivered is auto-refunded after up to 10 hours.

Rate limits (per token): If a token already has 500 requests in flight, a further submit is rejected with 400 too many pending requests — drain below the cap (or wait for completions), then retry. 10 jobs are processed at once. Limits are independent per service and per token.

The response includes statistics (total, found) and state (e.g. PENDING) to track progress.

🔗 Related Endpoints:
  • People Search — produces the trackId (run it first)
  • Email Finder Statistics — poll job progress (free)
  • Email Finder Results — fetch the found emails, paginated (free)
  • Email Finder Submissions — your submission & refund history (free)
  • Resend Email Finder Webhook — re-trigger delivery (free)
  • Export People with Email — prefer this to do search + emails in one call

📘 Webhook Payload: For the full webhook response schema, see Find Emails Webhook Payload. 🔄 Retry: We automatically retry webhook delivery up to 3 times.

The header Content-Type: application/json must be included in the request.