verify_batch
Submit up to 50,000 email addresses for asynchronous bulk verification, returning a batch ID to track progress and retrieve results later.
Instructions
Submit many email addresses for asynchronous bulk verification. Returns a batchId immediately; the job runs in the background. Poll get_batch_status until status is 'completed', then call get_batch_results. Reserves 1 credit per address. Prefer verify_email for one-off checks.
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": "verify_batch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional human-friendly label for the batch. | |
| emails | Yes | Array of email addresses to verify. | |
| webhookUrl | No | Optional HTTPS URL to receive a signed batch.completed callback. |