list_batches
List the caller's bulk-verification batches, newest first, paginated with limit (default 20, cap 96) and offset, optionally narrowed by status, a part of the name (search) and a creation range (from, to), and sorted by created_at, name or total with order. Use it to find a batch_uuid or review recent bulk work; for single-address verifications use list_jobs instead, and for one batch's detail use get_batch. Requires the results:read scope.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_batches"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Keep only the batches created at or before this RFC 3339 time. | |
| from | No | Keep only the batches created at or after this RFC 3339 time. | |
| sort | No | Order by created_at (default), name, or total (the number of addresses). | |
| limit | No | Number of batches to return (API default 20, cap 96). | |
| order | No | Order direction: desc (default) or asc. | |
| offset | No | Number of batches to skip (default 0). | |
| search | No | Keep only the batches whose name contains this text, ignoring case. | |
| status | No | Keep only the batches in one of these statuses: pending, validating, processing, paused, completed, partially_completed, failed, canceled. |