---
title: "Get batches"
method: GET
path: "/batches"
tags: ["Batch"]
---

# Get batches

`GET /batches`

Get batches

**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>

## Query parameters

- `offset` integer
- `limit` integer
- `status` 'pending' | 'inProgress' | 'finished' | 'stopped'
- `dateFrom` string
- `dateTo` string
- `endpoint` 'products' | 'contacts' | 'events', required

## Headers

- `Omnisend-Version` string, required

## Response `200`

List of batches

- ListBatchesResponse
  - `batches` 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
  - `paging` Paging
    - `limit` integer
    - `next` string
    - `offset` integer
    - `previous` string

## Other responses

- `400` — Validation failed
- `403` — Forbidden
- `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)