Email Finder Results API

💳 Credit Usage: Free — fetching results never costs credits (you already paid at submission). Paginate with page (zero-based) and size (1–100, default 10). Export People Results: returns 409 while the export is still in progress — poll Statistics until state: DONE. Email Finder Results: readable while running; unfinished items show state: PROCESSING. A fully refunded (STUCK_*) trackId returns 403 — resubmit it.


Returns paginated email finder results for a given trackId. The trackId is from the Find Emails by Track ID response. Use the page and size query parameters to paginate through results.

Each item includes a refId, state, input (firstname, lastname, domain), and output (email results with verification details).

Email Verification: All emails (SMTP & CATCH_ALL) returned by the API are verified in real time by BounceBan.

Fully-refunded submissions: if the submission was auto-refunded for non-delivery (STUCK_HARD_REFUND / STUCK_SOFT_REFUND), this endpoint returns 403 Forbidden with an actionable message — the results are not retrievable, so submit the request again. If it was refunded because there was no deliverable result (SEARCH_NO_RESULTS / NO_EMAILS_FOUND), it returns 200 with an empty page.

Path Params
uuid
required
Defaults to 719aba5a-876f-4690-bb57-5157153836b4

The track ID from a Find Emails by Track ID response.

Query Params
integer
≥ 0
Defaults to 0

Zero-based page index.

integer
1 to 100
Defaults to 10

Number of items per page.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json