---
title: "List Batch Items"
method: GET
path: "/storage_batch/{batch_id}/items"
tags: ["Pipeline Observability"]
---

# List Batch Items

`GET /storage_batch/{batch_id}/items`

## Request

- Base URL: `https://api.mosaic.so`
- URL: `https://api.mosaic.so/storage_batch/{batch_id}/items`
- Auth: HTTP bearer

List uploaded assets/events assigned to an authorized batch. updated_from is unsupported because batch items are immutable.

## Path parameters

- `batch_id` string, uuid, required

## Query parameters

- `limit` integer
- `cursor` string
- `from` string, date-time
- `to` string, date-time
- `workspace_id` string, uuid

## Headers

- `X-Workspace-Id` string, uuid

## Response `200`

Current organization-scoped evidence.

- object
  - `items` CanvasBatchItem[]
    - `id` string, uuid, required: Batch item ID.
    - `created_at` string, date-time, required: Assignment creation time.
    - `storage_event_id` string, uuid, required: Linked storage event.
    - `storage_events` object, required
      - `id` string, uuid, required: Storage event ID.
      - `created_at` string, date-time, required: Event creation time.
      - `updated_at` string, date-time, required: Last event row update.
      - `provider` string, required: google_drive, dropbox, or aws_s3.
      - `name` string, nullable, required: File or folder name.
      - `status` string, required: Event status, for example pending, processed, ignored, or error.
      - `attempts` integer, required: Processing attempt count.
      - `last_error` string, nullable, required: Last ingestion error, including errors that occur before any batch is created.
      - `drive_node_id` string, nullable, required: Provider file/folder ID for Drive or Dropbox.
      - `drive_parent_id` string, nullable, required: Provider parent folder ID.
      - `drive_path` string, nullable, required: Recorded event path; may be unavailable.
      - `s3_bucket` string, nullable, required: S3 bucket.
      - `s3_object_key` string, nullable, required: S3 object key.
  - `next_cursor` string, nullable: Opaque cursor for the next page; null at the end.
  - `batch_id` string, uuid: Requested batch ID.

## Other responses

- `400`: Invalid UUID, cursor, limit, timestamp, filter, or unsupported updated_from on batch items.
- `401`: Missing, invalid, or revoked API key.
- `403`: Insufficient API key scope, unavailable paid-plan access, or workspace header/query mismatch. Scope errors include code, required_scope, granted_scopes, retryable, and resolution. Other authorization errors retain detail.
- `404`: Requested run, trigger, or batch is absent or outside the authorized organization/workspace.
- `500`: Database or query failure. Never interpret this as an empty successful result; use bounded backoff.

---

[API](https://skmtc.dev/mosaic/apis/mosaic-ai-api.md) - [All operations](https://skmtc.dev/mosaic/apis/mosaic-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mosaic/apis/mosaic-ai-api/revisions/c20e9fc606a4?raw)