---
title: "Get batch information"
method: GET
path: "/batches/{batchID}"
tags: ["Batch"]
---

# Get batch information

`GET /batches/{batchID}`

Get batch information

**Scopes:**
`products.read`, `contacts.read`, `events.read`
<br><a href="https://www.postman.com/omnisend-api/workspace/omnisend/overview" target="_blank">Open Postman collection</a>

## Path parameters

- `batchID` string, required

## Headers

- `Omnisend-Version` string, required

## Response `200`

Batch information

- Batch
  - `batchID` string
  - `createdAt` string
  - `endedAt` string
  - `endpoint` string
  - `errors` BatchItem[]
    - `itemID` string
    - `request` unknown
    - `response` unknown
    - `responseCode` integer
    - `status` string
  - `errorsCount` integer
  - `eventID` string
  - `finishedCount` integer
  - `method` string
  - `origin` string
  - `responses` BatchItem[]
    - `itemID` string
    - `request` unknown
    - `response` unknown
    - `responseCode` integer
    - `status` string
  - `startedAt` string
  - `status` string
  - `totalCount` integer

## Other responses

- `400` — Validation failed
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.dev/omnisend/apis/events-api.md) · [All operations](https://skmtc.dev/omnisend/apis/events-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisend/events-api/revisions/50214fbc283f/schema)