API Reference

Job Data Points

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Query project job data points

client.jobDataPoints.list(JobDataPointListParams { job_type, created_at_on_or_after, created_at_on_or_before, 6 more } query, RequestOptionsoptions?): PaginatedCursor<JobDataPoint { id, created_at, custom_tag, 5 more } >

GET/api/v1/job-data-points

Returns paginated job data points for the current project.

ParametersExpand Collapse

query: JobDataPointListParams { job_type, created_at_on_or_after, created_at_on_or_before, 6 more }

job_type: "classify" | "extract" | "parse"

Job type to query.

One of the following:

"classify"

"extract"

"parse"

created_at_on_or_after?: string | null

Include items created at or after this timestamp (inclusive)

formatdate-time

created_at_on_or_before?: string | null

Include items created at or before this timestamp (inclusive)

formatdate-time

hours?: number

Hours of history to include.

maximum168

minimum1

organization_id?: string | null

page_size?: number | null

Number of items per page.

page_token?: string | null

Cursor token for the next page.

project_id?: string | null

status?: Array<string> | null

Filter by status.

ReturnsExpand Collapse

JobDataPoint { id, created_at, custom_tag, 5 more }

A job data point.

id: string

Job ID.

created_at: string

Created timestamp.

formatdate-time

custom_tag: string

Custom tag.

project_id: string

Project ID.

status: string

Job status.

updated_at: string

Updated timestamp.

formatdate-time

error_message?: string | null

Error message, if any.

state_transitions?: StateTransitions { cancelled_at, completed_at, failed_at, 3 more }

Job state transition timestamps.

cancelled_at?: string | null

completed_at?: string | null

failed_at?: string | null

pending_at?: string | null

running_at?: string | null

throttled_at?: string | null

Query project job data points

TypeScript

HTTP

TypeScript

Python

Go

Java

C#

CLI Tool

import LlamaCloud from '@llamaindex/llama-cloud';

const client = new LlamaCloud({
  apiKey: process.env['LLAMA_CLOUD_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const jobDataPoint of client.jobDataPoints.list({ job_type: 'parse' })) {
  console.log(jobDataPoint.id);
}

200 example

{
  "items": [
    {
      "id": "pjb-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "created_at": "2026-04-29T18:00:00Z",
      "custom_tag": "premium",
      "project_id": "11111111-1111-1111-1111-111111111111",
      "status": "completed",
      "updated_at": "2026-04-29T18:01:00Z",
      "error_message": "Failed to process file.",
      "state_transitions": {
        "cancelled_at": "2026-04-29T18:01:00Z",
        "completed_at": "2026-04-29T18:01:00Z",
        "failed_at": "2026-04-29T18:01:00Z",
        "pending_at": "2026-04-29T18:00:00Z",
        "running_at": "2026-04-29T18:00:05Z",
        "throttled_at": "2026-04-29T18:00:02Z"
      }
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}

Returns Examples

200 example

{
  "items": [
    {
      "id": "pjb-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "created_at": "2026-04-29T18:00:00Z",
      "custom_tag": "premium",
      "project_id": "11111111-1111-1111-1111-111111111111",
      "status": "completed",
      "updated_at": "2026-04-29T18:01:00Z",
      "error_message": "Failed to process file.",
      "state_transitions": {
        "cancelled_at": "2026-04-29T18:01:00Z",
        "completed_at": "2026-04-29T18:01:00Z",
        "failed_at": "2026-04-29T18:01:00Z",
        "pending_at": "2026-04-29T18:00:00Z",
        "running_at": "2026-04-29T18:00:05Z",
        "throttled_at": "2026-04-29T18:00:02Z"
      }
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}