get_batch_results
Fetch the per-email results of a batch (uuid, custom_id, status, score, verdict, recommendation and mailbox per row, mailbox saying whether the mail server confirmed the mailbox itself; custom_id echoes whatever was supplied at submit), paginated with limit (default 20, cap 96) and offset; total counts the matching rows across every page. Pass recommendation (send, review, remove) or verdict (valid, risky, invalid, unknown) to read only the rows to act on, for example the addresses to remove, instead of every page; a row still in progress matches neither. Pass status (pending, queued, processing, completed, failed, canceled) to find the rows that failed or are still waiting. Rows come in submission order unless sort (score, started_at) and order (desc, asc) say otherwise. Use it once get_batch shows the batch is done, or to page through results as they arrive; for the batch totals alone use get_batch. Requires the results:read 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": {
"batch_uuid": "<batch_uuid>"
},
"name": "get_batch_results"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Order by score or started_at instead of submission order (the default), for example the lowest scores first with order asc. A row without a score, or not started yet, sorts as the smallest. | |
| limit | No | Number of results to return (API default 20, cap 96). | |
| order | No | Order direction with sort: desc (default) or asc. | |
| offset | No | Number of results to skip (default 0). | |
| status | No | Keep only the rows in one of these statuses: pending, queued, processing, completed, failed, canceled. Use it to find the addresses that failed or are still waiting. | |
| verdict | No | Keep only the rows with one of these verdicts: valid, risky, invalid, unknown. Combined with status and recommendation using AND. | |
| batch_uuid | Yes | Public batch UUID returned by submit_batch or list_batches. | |
| recommendation | No | Keep only the rows with one of these recommendations: send, review, remove. Use it to fetch just the addresses to remove or to review instead of paging through the whole batch. |