---
title: "Get Tool Job Batches"
method: GET
path: "/api/tool-jobs/{job_id}/batches"
tags: ["growth-artifact-jobs"]
---

# Get Tool Job Batches

`GET /api/tool-jobs/{job_id}/batches`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/tool-jobs/{job_id}/batches`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Path parameters

- `job_id` string, required

## Query parameters

- `after_batch_id` string, nullable
- `limit` integer

## Response `200`

Successful Response

- ToolJobBatchesResponse
  - `artifact_id` string, nullable, required: Readable result artifact identity.
  - `batches` ToolJobBatchResponse[], required: Ordered committed artifact batches.
    - `artifact_id` string, required: Immutable artifact containing this batch.
    - `batch_id` string, required: Immutable batch identity.
    - `end_row_index` integer, required: Last immutable row index in the batch.
    - `metadata` ArtifactPublicMetadata, required: Sanitized producer metadata. Keys vary by tool kind; secret and private storage-coordinate keys are removed recursively.
    - `row_count` integer, required: Rows committed in this batch.
    - `start_row_index` integer, required: First immutable row index in the batch.
  - `error_message` string, nullable, required: Terminal public failure detail, or null.
  - `event_cursor` integer, required: Newest durable event sequence observed.
  - `failed` boolean, required: True when the durable status is failed.
  - `finished` boolean, required: True after a durable terminal event exists.
  - `has_more` boolean, required: True when more artifact batches follow this page.
  - `job_id` string, required: Durable job identity.
  - `phase` string, required: Current producer-defined execution phase.
  - `status` 'queued' | 'running' | 'blocked' | 'completed' | 'failed', required: Durable job lifecycle status.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)