---
title: "Get Style Agent Batch"
method: GET
path: "/style-agent/batch/{batch_id}"
tags: ["styleAgent"]
---

# Get Style Agent Batch

`GET /style-agent/batch/{batch_id}`

Live report for a batch: status, per-status counts, and per-document
workflow ids + status. Fetch a document's full result by its ``workflow_id``
from ``GET /style-agent/workflows/{workflow_id}``.

This report is the authoritative view of a batch's progress and completion;
the optional completion webhook is a best-effort notification on top of it.

## Path parameters

- `batch_id` string, required

## Query parameters

- `item_limit` integer
- `item_offset` integer

## Headers

- `Authorization` string, required

## Response `200`

Successful Response

- BatchReportResponse — Live report for GET /style-agent/batch/{id} (D5/D12).
  - `batch_id` string, required
  - `status` 'running' | 'completed', required — Lifecycle of a style-agent batch (see design-docs/style-agent-batch-checking.md). A batch is ``running`` while any item is non-terminal; it becomes ``completed`` (and ``sealed``) once every item reaches a terminal state.
  - `sealed` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `item_count` integer, required
  - `counts` BatchCounts, required
    - `total` integer
    - `pending` integer
    - `running` integer
    - `completed` integer
    - `failed` integer
  - `items` BatchItemResponse[], required
    - `item_id` string, required
    - `document_ref` string, nullable
    - `workflow_id` string, required
    - `status` 'pending' | 'running' | 'completed' | 'failed', required — Per-document status within a batch, cached from the child workflow.
    - `error_category` 'input' | 'processing' — Why a batch item failed (D7): a bad request vs. a processing/system fault.

## Other responses

- `401` — Authentication failed or no valid API key provided.
- `403` — Forbidden
- `404` — Batch not found
- `422` — Validation Error
- `500` — Internal Server Error

---

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