Actions13
- Batch Actions
- Batch Sync Actions
- Credit Actions
- Domain Actions
- Real Time Actions
- Toxicity Actions
Batch → Create Batch Request
AI-generatedSummary
Send a batch request to verify multiple email addresses offline via the Bouncer API.
Inputs
- E-Mails (required) — A JSON array of email addresses to verify, e.g., [{ "email": "jane@usebouncer.com" }, { "email": "john@usebouncer.com" }]. Maximum 100,000 emails allowed, recommended batch sizes between 1,000 and 10,000. The rate limit is 60 batches per minute.
- Callback URL — An optional HTTP URL to receive a notification callback when the batch verification is complete.
- Request Options — Node settings including batching controls to split large input into smaller batches with interval timing, proxy configuration, timeout in milliseconds for the request, and whether to ignore SSL validation errors.
Output shape
A single batch creation response object containing details including batch ID used for status and results retrieval.
The operation returns immediately after batch creation with a batch ID; the email verification is performed asynchronously. Users can use other batch operations with the returned batch ID to check status, retrieve results, delete, or finish the batch. Rate limits and size constraints apply as described in inputs.
Examples
Example 1: Verify 5000 emails offline
Set 'E-Mails' to a JSON array of 5000 email objects to verify, optionally provide a 'Callback URL' to be notified upon completion, and configure batching options if necessary to throttle requests.