---
title: "List Batch Job Items"
method: GET
path: "/api/v1/beta/batch-processing/{job_id}/items"
tags: ["Beta", "Batch Processing"]
---

# List Batch Job Items

`GET /api/v1/beta/batch-processing/{job_id}/items`

List items in a batch job with optional status filtering.

Useful for finding failed items, viewing completed items,
or debugging processing issues.

## Path parameters

- `job_id` string, required

## Query parameters

- `status` 'pending' | 'processing' | 'completed' | 'failed' | 'skipped' | 'cancelled' — Status of an individual file in a batch job.
- `limit` integer — Maximum number of items to return
- `offset` integer — Number of items to skip
- `project_id` string, uuid, nullable
- `organization_id` string, uuid, nullable

## Cookies

- `session` string, nullable

## Response `200`

Successful Response

- BatchItemListResponse — Paginated response containing batch job item details.
  - `items` BatchItemDetail[] — List of item details
    - `status` 'pending' | 'processing' | 'completed' | 'failed' | 'skipped' | 'cancelled', required — Status of an individual file in a batch job.
    - `effective_at` string, date-time
    - `job_record_id` string, nullable — The job record ID associated with this status, if any.
    - `error_message` string, nullable — Error message for the latest job attempt, if any.
    - `item_id` string, required — ID of the item
    - `item_name` string, required — Name of the item
    - `job_id` string, nullable — Job ID for the underlying processing job (links to parse/extract job results)
    - `skip_reason` string, nullable — Reason item was skipped (e.g., 'already_processed', 'size_limit_exceeded')
    - `started_at` string, date-time, nullable — When processing started for this item
    - `completed_at` string, date-time, nullable — When processing completed for this item
  - `next_page_token` string, nullable — A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.
  - `total_size` integer, nullable — The total number of items available. This is only populated when specifically requested. The value may be an estimate and can be used for display purposes only.

## Other responses

- `422` — Validation Error

## Changes

- **2026-06-09** `b17341164de9` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/run-llama/apis/llama-platform/changes/api/v1/beta/batch-processing/:job_id/items/get.md)

---

[API](https://skmtc.dev/run-llama/apis/llama-platform.md) · [All operations](https://skmtc.dev/run-llama/apis/llama-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/run-llama/llama-platform/revisions/b17341164de9/schema)