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 ParametersExpand Collapse

job_id: string

Query ParametersExpand Collapse

limit: optional number

Maximum number of items to return

maximum1000

minimum1

offset: optional number

Number of items to skip

minimum0

organization_id: optional string

project_id: optional string

status: optional "pending" or "processing" or "completed" or 3 more

Filter items by status

One of the following:

"pending"

"processing"

"completed"

"failed"

"skipped"

"cancelled"

Cookie ParametersExpand Collapse

session: optional string

ReturnsExpand Collapse

items: optional array of object { item_id, item_name, status, 7 more }

List of item details

item_id: string

ID of the item

item_name: string

Name of the item

status: "pending" or "processing" or "completed" or 3 more

Processing status of this item

One of the following:

"pending"

"processing"

"completed"

"failed"

"skipped"

"cancelled"

completed_at: optional string

When processing completed for this item

formatdate-time

effective_at: optional string

error_message: optional string

Error message for the latest job attempt, if any.

job_id: optional string

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

job_record_id: optional string

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

skip_reason: optional string

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

started_at: optional string

When processing started for this item

formatdate-time

next_page_token: optional string

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: optional number

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.

List Batch Job Items

curl https://api.cloud.llamaindex.ai/api/v1/beta/batch-processing/$JOB_ID/items \
    -H "Authorization: Bearer $LLAMA_CLOUD_API_KEY"

{
  "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

{
  "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
}