---
title: "Retrieve a batch"
method: GET
path: "/email/batches/{id}"
tags: ["Emails"]
---

# Retrieve a batch

`GET /email/batches/{id}`

## Request

- Base URL: `https://www.unitpost.com/api/v1`
- URL: `https://www.unitpost.com/api/v1/email/batches/{id}`
- Auth: HTTP bearer

Retrieve a batch and its live, per-status rollup (how many of its messages are queued, sent, delivered, bounced, and so on). The counts update as the batch progresses. Create a batch with [Send a batch of emails](#post-email-batch), or stop its remaining messages with [Cancel a batch](#post-email-batches-id-cancel). Requires the `emails:read` capability.

## Response `200`

The batch.

- Batch
  - `object` 'batch', required
  - `id` string, required
  - `count` integer, required
  - `scheduled_at` string, nullable, required
  - `created_at` string, required
  - `status_counts` object, required: Live child counts keyed by status (e.g. { delivered: 98, failed: 2 }).
  - `cancelable` integer, required

## Other responses

- `401`: Missing or invalid API key.
- `403`: Insufficient scope.
- `404`: Batch not found.

---

[API](https://skmtc.dev/unitpost/apis/unitpost-api.md) · [All operations](https://skmtc.dev/unitpost/apis/unitpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unitpost/apis/unitpost-api/revisions/86ff7c890967?raw)