Bounceban · Contact Data

BounceBan / Bulk results (all)

Retrieve verification results for a bulk email verification task using a task ID in JSON format. Results are available within 90 days of verification.

When making a request with the state parameter included, you might not receive all the verified results if the task is not yet finished. To obtain a comprehensive list of the verified emails that have been processed so far, you should omit the state parameter from your request.

Live data

You are looking at the live public catalog.

unverifiedRequest shape unavailableUnverified

Published API evidence

Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

cursor query · optional
(Optional) Provide this parameter to retrieve results from the next page. You can obtain the cursor value from the previous rquest response. <br> If `retrieve_all` is set to `1`, the `page_size` and `cursor` parameters will be ignored.
id query · required
Bulk email verification task ID.
page_size query · optional
(Optional) Specify the number of emails to return per request. Default: 100. Maximum: 3,000. Minimum: 100. <br> If `retrieve_all` is set to `1`, the `page_size` and `cursor` parameters will be ignored.
retrieve_all query · optional
(Optional) Retrieve all emails for the task by setting this parameter to `1`. Default: Disabled (empty). <br> Important Notes: If `retrieve_all` is set to `1`, the `page_size` and `cursor` parameters will be ignored. This parameter is only effective
state query · optional
Specifies emails to retrieve based on verification state (`deliverable`, `undeliverable `, `risky`, or `unknown`). If not set, all emails will be returned. When making a request with the `state` parameter included, you might not receive all the verif

Provider docs How to run it