List Batch Job Items

client.Beta.Batch.JobItems.List(ctx, jobID, query) (*PaginatedBatchItems[BetaBatchJobItemListResponse], error)

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

jobID string

query BetaBatchJobItemListParams

Limit param.Field[int64]optional

Maximum number of items to return

maximum1000

minimum1

Offset param.Field[int64]optional

Number of items to skip

minimum0

OrganizationID param.Field[string]optional

ProjectID param.Field[string]optional

Status param.Field[BetaBatchJobItemListParamsStatus]optional

Filter items by status

const BetaBatchJobItemListParamsStatusPending BetaBatchJobItemListParamsStatus = "pending"

const BetaBatchJobItemListParamsStatusProcessing BetaBatchJobItemListParamsStatus = "processing"

const BetaBatchJobItemListParamsStatusCompleted BetaBatchJobItemListParamsStatus = "completed"

const BetaBatchJobItemListParamsStatusFailed BetaBatchJobItemListParamsStatus = "failed"

const BetaBatchJobItemListParamsStatusSkipped BetaBatchJobItemListParamsStatus = "skipped"

const BetaBatchJobItemListParamsStatusCancelled BetaBatchJobItemListParamsStatus = "cancelled"

ReturnsExpand Collapse

type BetaBatchJobItemListResponse struct{…}

Detailed information about an item in a batch job.

ItemID string

ID of the item

ItemName string

Name of the item

Status BetaBatchJobItemListResponseStatus

Processing status of this item

One of the following:

const BetaBatchJobItemListResponseStatusPending BetaBatchJobItemListResponseStatus = "pending"

const BetaBatchJobItemListResponseStatusProcessing BetaBatchJobItemListResponseStatus = "processing"

const BetaBatchJobItemListResponseStatusCompleted BetaBatchJobItemListResponseStatus = "completed"

const BetaBatchJobItemListResponseStatusFailed BetaBatchJobItemListResponseStatus = "failed"

const BetaBatchJobItemListResponseStatusSkipped BetaBatchJobItemListResponseStatus = "skipped"

const BetaBatchJobItemListResponseStatusCancelled BetaBatchJobItemListResponseStatus = "cancelled"

CompletedAt Timeoptional

When processing completed for this item

formatdate-time

EffectiveAt Timeoptional

ErrorMessage stringoptional

Error message for the latest job attempt, if any.

JobID stringoptional

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

JobRecordID stringoptional

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

SkipReason stringoptional

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

StartedAt Timeoptional

When processing started for this item

formatdate-time

List Batch Job Items

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/llamacloud-prod-go"
  "github.com/stainless-sdks/llamacloud-prod-go/option"
)

func main() {
  client := llamacloudprod.NewClient(
    option.WithAPIKey("My API Key"),
  )
  page, err := client.Beta.Batch.JobItems.List(
    context.TODO(),
    "job_id",
    llamacloudprod.BetaBatchJobItemListParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}

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