submit_batch
Submit a list of emails (up to 4096 per call) for bulk verification and return a batch_uuid. Use it for 20 or more addresses; for fewer use verify_email, since a batch closed by this call needs at least 20 distinct valid addresses. Billed per unique valid address, and governed by the plan's batch_max (see get_pricing). The optional checks list picks which checks run (syntax, mx, smtp, disposable, role, free, catchall). Each check is billed at its own price, returned by get_pricing. Omitting checks runs every check your plan allows, which is the most reliable answer and costs the most tokens; naming fewer costs less. A check outside your plan is refused. Processing is asynchronous: follow progress with get_batch and read per-email results with get_batch_results. Set final to false to keep intake open and feed more chunks with append_batch_emails. Requires the email:verify:bulk scope.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"emails": "<emails>"
},
"name": "submit_batch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| final | No | Whether this is the batch's only or final chunk (defaults to true). Set false to keep intake open, then feed further chunks with append_batch_emails. | |
| checks | No | Optional check wire strings (syntax, mx, smtp, disposable, role, free, catchall). Each check is billed at its own price (see get_pricing). Omit to run every check your plan allows, the most reliable answer and the most tokens; naming fewer costs less. A check outside your plan is refused. | |
| emails | Yes | Email addresses to verify (up to 4096). Billed per unique valid address and governed by the caller's plan batch_max (see get_pricing). A batch closed by this call (final: true, the default) needs at least batch_min (20) distinct valid addresses; verify fewer with verify_email. | |
| custom_ids | No | Optional per-email client references, index-aligned 1:1 with emails. Echoed back verbatim in get_batch_results so you can map each result to your input row. Do not put the email address or any PII here, use your own row identifier (e.g. a CRM id). |