API Reference

Beta

Batch

Job Items

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

List Batch Job Items

JobItemListPage beta().batch().jobItems().list(JobItemListParamsparams = JobItemListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

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.

ParametersExpand Collapse

JobItemListParams params

Optional<String> jobId

Optional<Long> limit

Maximum number of items to return

maximum1000

minimum1

Optional<Long> offset

Number of items to skip

minimum0

Optional<String> organizationId

Optional<String> projectId

Optional<Status> status

Filter items by status

PENDING("pending")

PROCESSING("processing")

COMPLETED("completed")

FAILED("failed")

SKIPPED("skipped")

CANCELLED("cancelled")

ReturnsExpand Collapse

class JobItemListResponse:

Detailed information about an item in a batch job.

String itemId

ID of the item

String itemName

Name of the item

Status status

Processing status of this item

One of the following:

PENDING("pending")

PROCESSING("processing")

COMPLETED("completed")

FAILED("failed")

SKIPPED("skipped")

CANCELLED("cancelled")

Optional<LocalDateTime> completedAt

When processing completed for this item

formatdate-time

Optional<LocalDateTime> effectiveAt

Optional<String> errorMessage

Error message for the latest job attempt, if any.

Optional<String> jobId

Job ID for the underlying processing job (links to parse/extract job results)

Optional<String> jobRecordId

The job record ID associated with this status, if any.

Optional<String> skipReason

Reason item was skipped (e.g., ‘already_processed’, ‘size_limit_exceeded’)

Optional<LocalDateTime> startedAt

When processing started for this item

formatdate-time

List Batch Job Items

Java

HTTP

TypeScript

Python

Java

Go

CLI Tool

package com.llamacloud_prod.api.example;

import com.llamacloud_prod.api.client.LlamaCloudClient;
import com.llamacloud_prod.api.client.okhttp.LlamaCloudOkHttpClient;
import com.llamacloud_prod.api.models.beta.batch.jobitems.JobItemListPage;
import com.llamacloud_prod.api.models.beta.batch.jobitems.JobItemListParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        LlamaCloudClient client = LlamaCloudOkHttpClient.fromEnv();

        JobItemListPage page = client.beta().batch().jobItems().list("job_id");
    }
}

200 example

{
  "items": [
    {
      "item_id": "item_id",
      "item_name": "item_name",
      "status": "pending",
      "completed_at": "2019-12-27T18:11:19.117Z",
      "effective_at": "2019-12-27T18:11:19.117Z",
      "error_message": "error_message",
      "job_id": "job_id",
      "job_record_id": "job_record_id",
      "skip_reason": "skip_reason",
      "started_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}

Returns Examples

200 example

{
  "items": [
    {
      "item_id": "item_id",
      "item_name": "item_name",
      "status": "pending",
      "completed_at": "2019-12-27T18:11:19.117Z",
      "effective_at": "2019-12-27T18:11:19.117Z",
      "error_message": "error_message",
      "job_id": "job_id",
      "job_record_id": "job_record_id",
      "skip_reason": "skip_reason",
      "started_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}