---
title: "List batch items"
method: GET
path: "/v1/batches/{batchId}/items"
tags: ["batches"]
---

# List batch items

`GET /v1/batches/{batchId}/items`

## Request

- Base URL: `https://api.olostep.com`
- URL: `https://api.olostep.com/v1/batches/{batchId}/items`
- Auth: HTTP bearer

Retrieves the list of items processed for a batch.

## Path parameters

- `batchId` string, required

## Query parameters

- `status` 'completed' | 'failed'
- `cursor` integer
- `limit` integer

## Response `200`

Default Response

- object: A page of batch items.
  - `id` string, required
  - `object` 'batch', required
  - `status` string, required
  - `items` object[], required
    - `custom_id` string, required
    - `retrieve_id` string, required
    - `url` string, required
    - `metadata` object
  - `items_count` integer, required
  - `cursor` integer

## Other responses

- `400`: Default Response
- `401`: Default Response
- `404`: Default Response
- `502`: Default Response

---

[API](https://skmtc.dev/olostep/apis/olostep-api.md) · [All operations](https://skmtc.dev/olostep/apis/olostep-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olostep/apis/olostep-api/revisions/13c766ab100c?raw)