---
title: "Poll batch progress"
method: GET
path: "/batch/{id}/progress"
tags: ["batch"]
---

# Poll batch progress

`GET /batch/{id}/progress`

Returns the current progress of a batch operation. Poll this endpoint until `status` is `completed`. When completed, a `results_url` is included. If all tasks failed, an `error` field is included with the failure reason.

## Path parameters

- `id` string, required

## Headers

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

## Response `200`

Successful response with current batch progress

- BatchProgressResponse
  - `version` string, required
  - `batch_id` string, required — The batch identifier
  - `progress` number, double, required — Fraction of tasks completed (0.0 to 1.0). Value of 1.0 means all tasks have finished (success or failure).
  - `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
  - `status` 'processing' | 'completed', required — `processing` while tasks are running; `completed` when all tasks have finished (regardless of individual success/failure)
  - `results_url` string, nullable — URL to fetch per-task results. Present only when `status` is `completed`.
  - `error` string, nullable — Error message when all tasks in the batch failed. Null otherwise.

## Other responses

- `401` — Unauthorized - Authentication required or invalid credentials
- `403` — Forbidden - Access denied or insufficient permissions
- `404` — Not found — no batch with this ID, or it does not belong to the authenticated user (the response is identical either way, by design, so existence of another user's batch is never revealed)

---

[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)