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

JobDataPointListPage jobDataPoints().list(JobDataPointListParamsparams, RequestOptionsrequestOptions = RequestOptions.none())

GET/api/v1/job-data-points

Returns paginated job data points for the current project.

ParametersExpand Collapse

JobDataPointListParams params

JobType jobType

Job type to query.

CLASSIFY("classify")

EXTRACT("extract")

PARSE("parse")

Optional<LocalDateTime> createdAtOnOrAfter

Include items created at or after this timestamp (inclusive)

formatdate-time

Optional<LocalDateTime> createdAtOnOrBefore

Include items created at or before this timestamp (inclusive)

formatdate-time

Optional<Long> hours

Hours of history to include.

maximum168

minimum1

Optional<String> organizationId

Optional<Long> pageSize

Number of items per page.

Optional<String> pageToken

Cursor token for the next page.

Optional<String> projectId

Optional<List<String>> status

Filter by status.

ReturnsExpand Collapse

class JobDataPoint:

A job data point.

String id

Job ID.

LocalDateTime createdAt

Created timestamp.

formatdate-time

String customTag

Custom tag.

String projectId

Project ID.

String status

Job status.

LocalDateTime updatedAt

Updated timestamp.

formatdate-time

Optional<String> errorMessage

Error message, if any.

Optional<StateTransitions> stateTransitions

Job state transition timestamps.

Optional<LocalDateTime> cancelledAt

Optional<LocalDateTime> completedAt

Optional<LocalDateTime> failedAt

Optional<LocalDateTime> pendingAt

Optional<LocalDateTime> runningAt

Optional<LocalDateTime> throttledAt

Query project job data points

Java

HTTP

TypeScript

Python

Go

Java

C#

CLI Tool

package ai.llamaindex.llamacloud.example;

import ai.llamaindex.llamacloud.client.LlamaCloudClient;
import ai.llamaindex.llamacloud.client.okhttp.LlamaCloudOkHttpClient;
import ai.llamaindex.llamacloud.models.jobdatapoints.JobDataPointListPage;
import ai.llamaindex.llamacloud.models.jobdatapoints.JobDataPointListParams;

public final class Main {
    private Main() {}

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

        JobDataPointListParams params = JobDataPointListParams.builder()
            .jobType(JobDataPointListParams.JobType.PARSE)
            .build();
        JobDataPointListPage page = client.jobDataPoints().list(params);
    }
}

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
}