Get a batch verification
emailable_get_batchRead-only
Status and results of a batch made with emailable_create_batch: message, progress (processed/total), reason_counts and total_counts (deliverable, undeliverable, risky, unknown). Batches of up to 1,000 emails also return the results inline in emails (30 days). They come in pages: up to limit results, fewer if the reply would get too long; ask for the next page with emails_page.next_offset. A bigger batch returns download_file, a temporary link (5 days) to a ZIP of a CSV: share it only with the account owner. Free to call. GET /v1/batch.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The batch id. | |
| limit | No | Most results per call, 1-1000 (default 100). A reply can hold fewer; use emails_page.next_offset for the next page. | |
| offset | No | First result to return (default 0). | |
| partial | No | Include the results so far while the batch is still running (only for batches of up to 1,000 emails). | |
| include_emails | No | Include per-email results (default true). false returns the counts only. |