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

# Get batch information

`GET /batches/{batchID}`

## Request

- Base URL: `https://api.omnisend.com/api`
- URL: `https://api.omnisend.com/api/batches/{batchID}`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://app.omnisend.com/oauth2/token` scopes: `products.read`, `contacts.read`, `events.read`
  - API key in header `Authorization`

Get batch information

**Scopes:**
`products.read`, `contacts.read`, `events.read`

**Rate Limiting:**
This endpoint is rate limited to 400 requests per minute.

<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/batches-api.md) - [All operations](https://skmtc.dev/omnisend/apis/batches-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omnisend/apis/batches-api/revisions/9a6a0f68f6b6?raw)