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(ctx, query) (*PaginatedCursor[JobDataPoint], error)

GET/api/v1/job-data-points

Returns paginated job data points for the current project.

ParametersExpand Collapse

query JobDataPointListParams

JobType param.Field[JobDataPointListParamsJobType]

Job type to query.

const JobDataPointListParamsJobTypeClassify JobDataPointListParamsJobType = "classify"

const JobDataPointListParamsJobTypeExtract JobDataPointListParamsJobType = "extract"

const JobDataPointListParamsJobTypeParse JobDataPointListParamsJobType = "parse"

CreatedAtOnOrAfter param.Field[Time]Optional

Include items created at or after this timestamp (inclusive)

formatdate-time

CreatedAtOnOrBefore param.Field[Time]Optional

Include items created at or before this timestamp (inclusive)

formatdate-time

Hours param.Field[int64]Optional

Hours of history to include.

maximum168

minimum1

OrganizationID param.Field[string]Optional

PageSize param.Field[int64]Optional

Number of items per page.

PageToken param.Field[string]Optional

Cursor token for the next page.

ProjectID param.Field[string]Optional

Status param.Field[[]string]Optional

Filter by status.

ReturnsExpand Collapse

type JobDataPoint struct{…}

A job data point.

ID string

Job ID.

CreatedAt Time

Created timestamp.

formatdate-time

CustomTag string

Custom tag.

ProjectID string

Project ID.

Status string

Job status.

UpdatedAt Time

Updated timestamp.

formatdate-time

ErrorMessage stringOptional

Error message, if any.

StateTransitions JobDataPointStateTransitionsOptional

Job state transition timestamps.

CancelledAt TimeOptional

CompletedAt TimeOptional

FailedAt TimeOptional

PendingAt TimeOptional

RunningAt TimeOptional

ThrottledAt TimeOptional

Query project job data points

Go

HTTP

TypeScript

Python

Go

Java

C#

CLI Tool

package main

import (
  "context"
  "fmt"

  "github.com/run-llama/llama-parse-go"
  "github.com/run-llama/llama-parse-go/option"
)

func main() {
  client := llamacloud.NewClient(
    option.WithAPIKey("My API Key"),
  )
  page, err := client.JobDataPoints.List(context.TODO(), llamacloud.JobDataPointListParams{
    JobType: llamacloud.JobDataPointListParamsJobTypeParse,
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}

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
}