If you need to verify multiple email addresses in a batch, you can use our
Batch Email Verification API.Bouncer distributed infrastructure will make sure to get best possible
results and retry any verification in case one is required.For example:
Please make sure to store batchId as it will be necessary to check
status and get results for the request.SpeedDefault settings allow our customers to verify 100-200k email addresses
per hour, however if your use case requires higher throughput, please let
us know and we will be able to adjust your configuration.Rate LimitingThe Batch Email Verification API is limited to creating up to 60 batches
per minute and 200 requests to other related endpoints.Batch size recommendationSingle batch can process up to 100,000 emails, while recommended size
would be anything between 1000-10000 emails.This method is recommended when the quality of verification is of a
value as it characterises the best precision of email validation and the
lowest possible amount of “unknown” results.CSV format supportBatch can also be created using txt file, with one email per file, and then results downloaded as csv file.Example file content
Integration flowThere are 2 ways to integrate with batch, using status endpoint or using
callback parameter.Using Status Endpoint
Copy
Ask AI
title Batch Integration Flow With Status EndpointClient->>Bouncer: POST /v1.1/email/verify/batchloop every 10-30s until status == 'completed' Client->>Bouncer: GET /v1.1/email/verify/batch/<ID>endClient->>Bouncer: GET/v1.1/email/verify/batch/<ID>/download?download=all
Using Callbacks
Copy
Ask AI
title Batch Integration Flow With CallbacksClient->>Bouncer: POST /v1.1/email/verify/batch?callback=<YOUR-URL>Bouncer->>Client: POST <YOUR-URL>Client->>Bouncer: GET/v1.1/email/verify/batch/<ID>/download?download=all