---
title: "Get Batch Status"
method: GET
path: "/v1/sending/batches/{batchId}"
tags: ["Emails"]
---

# Get Batch Status

`GET /v1/sending/batches/{batchId}`

Get the status of a batch email send. Requires API key with email:read.

## Path parameters

- `batchId` string, required

## Response `200`

Batch status

- ApiResponseBatchStatus
  - `success` boolean, required
  - `data` object, nullable
    - `batchId` string
    - `status` 'queued' | 'processing' | 'completed' | 'failed'
    - `recipientType` 'audience' | 'segment' | 'tag'
    - `recipientId` string
    - `provider` string
    - `totalCount` integer
    - `queuedCount` integer
    - `sentCount` integer
    - `failedCount` integer
    - `from` string
    - `fromName` string
    - `subject` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time, nullable
    - `error` string, nullable
  - `error` string, nullable

## Other responses

- `401` — Unauthorized
- `404` — Resource not found

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/revisions/2d06ad0e0bc3/schema)