How to Download All Results from the Single Verification API

While we don't currently offer a direct bulk download feature for individual verifications submitted via the API, you can retrieve this data by following a two-part process: first by downloading your credit usage logs to get the task IDs, and then by using an API endpoint to retrieve the results for each ID.

Here are the step-by-step instructions:

1. Go to the Credits Usage Page Visit your account's "Usage - credits" page here: https://bounceban.com/app/account/credits/usage

2. Download Consumption Log Choose the time frame you want to export and click the Download button. A CSV file containing your credit consumption logs will be downloaded. Note: If there are lots of verifications, please choose a shorter time frame. 

3. Filter and Find IDs Open the downloaded CSV file.

   • Find the 'Source' column and filter it to show only rows with the value "Single (API)".

   • The 'Task ID' column for these rows contains the unique ID for each single verification task. Save this list of IDs.

1. Use the Get Status Endpoint With your list of Task IDs, you can now programmatically retrieve the full verification details for each one.

2. Make API Calls For each Task ID you saved, make a GET request to the /v1/verify/single/status endpoint. Pass the Task ID as the id query parameter.

   Endpoint: GET /v1/verify/single/status

   Example Request: https://api.bounceban.com/v1/verify/single/status?id=YOUR_TASK_ID_HERE

   This endpoint will return the full JSON verification result for that specific task, including the email, result, score, and other details.

Important Notes:

• Requests to the /v1/verify/single/status endpoint do not cost verification credits.

• Verification results are available for retrieval for 90 days after the verification was completed.