---
title: "List batches"
method: GET
path: "/batch"
tags: ["batch"]
---

# List batches

`GET /batch`

Returns a paginated list of batch jobs belonging to the authenticated user, sorted by last modified time descending. Use the `status` filter to narrow results to in-progress or completed batches. Use `date_from` / `date_to` to filter by last modified time range.

## Query parameters

- `status` 'processing' | 'completed'
- `date_from` string, date-time
- `date_from_utc` string, date-time
- `date_to` string, date-time
- `date_to_utc` string, date-time
- `limit` integer
- `page` integer

## Headers

- `Authorization` string, required
- `X-Api-Key` string, required
- `X-API-Version` string

## Response `200`

Paginated list of batch jobs

- BatchGetBatchRootResponse200
  - `count` integer — Total number of batches matching the filter
  - `results` BatchGetResponsesContentApplicationJsonSchemaResultsItems[]
    - `batch_id` string, required — The batch identifier. Use this to poll `/batch/{id}/progress` or fetch `/batch/{id}/results`.
    - `status` 'processing' | 'completed', required — `processing` while tasks are running; `completed` when all tasks have finished
    - `progress` number, double, required — Fraction of tasks completed (0.0 to 1.0)
    - `tasks_count` integer, required — Total number of tasks in the batch
    - `tasks_completed` integer, required — Number of tasks that completed successfully
    - `tasks_failed` integer, required — Number of tasks that failed
    - `modified_at` string, required — Last time the batch was modified
    - `completed_at` string, nullable — When the batch finished, or null if still processing

## Other responses

- `400` — Bad request - Invalid parameters or request format
- `401` — Unauthorized - Authentication required or invalid credentials
- `403` — Forbidden - Access denied or insufficient permissions

---

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