Email Finder Results API

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