List Classify Jobs

ClassifyListPage classify().list(, )

GET/api/v2/classify

List classify jobs with optional filtering and pagination.

Filter by status, configuration_id, specific job_ids, or creation date range.

ParametersExpand Collapse

ClassifyListParams params

Optional<String> configurationId

Filter by configuration ID

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<List<String>> jobIds

Filter by specific job IDs

Optional<String> organizationId

Optional<Long> pageSize

Number of items per page

maximum100

minimum1

Optional<String> pageToken

Token for pagination

Optional<String> projectId

Optional<Status> status

Filter by job status

PENDING("PENDING")

RUNNING("RUNNING")

COMPLETED("COMPLETED")

FAILED("FAILED")

ReturnsExpand Collapse

class ClassifyListResponse:

Response for a classify job.

String id

Unique identifier

ClassifyConfiguration configuration

Classify configuration used for this job

List<Rule> rules

Classify rules to evaluate against the document (at least one required)

String description

Natural language criteria for matching this rule

maxLength500

minLength10

String type

Document type to assign when rule matches

maxLength50

minLength1

Optional<Mode> mode

Classify execution mode

Optional<ParsingConfiguration> parsingConfiguration

Parsing configuration for classify jobs.

Optional<String> lang

ISO 639-1 language code for the document

Optional<Long> maxPages

Maximum number of pages to process. Omit for no limit.

minimum1

Optional<String> targetPages

Comma-separated page numbers or ranges to process (1-based). Omit to process all pages.

DocumentInputType documentInputType

Whether the input was a file or parse job (FILE or PARSE_JOB)

One of the following:

URL("url")

FILE_ID("file_id")

PARSE_JOB_ID("parse_job_id")

String fileInput

ID of the input file or parse job

String projectId

Project this job belongs to

Status status

Current job status: PENDING, RUNNING, COMPLETED, or FAILED

One of the following:

PENDING("PENDING")

RUNNING("RUNNING")

COMPLETED("COMPLETED")

FAILED("FAILED")

String userId

User who created this job

Optional<String> configurationId

Product configuration ID

Optional<LocalDateTime> createdAt

Creation datetime

formatdate-time

Optional<String> errorMessage

Error message if job failed

Optional<String> parseJobId

Associated parse job ID

Optional<ClassifyResult> result

Result of classifying a document.

double confidence

Confidence score between 0.0 and 1.0

maximum1

minimum0

String reasoning

Why the document matched (or didn’t match) the returned rule

Optional<String> type

Matched rule type, or null if no rule matched

Optional<String> transactionId

Idempotency key

Optional<LocalDateTime> updatedAt

Update datetime

formatdate-time

List Classify Jobs

package com.llamacloud_prod.api.example;

import com.llamacloud_prod.api.client.LlamaCloudClient;
import com.llamacloud_prod.api.client.okhttp.LlamaCloudOkHttpClient;
import com.llamacloud_prod.api.models.classify.ClassifyListPage;
import com.llamacloud_prod.api.models.classify.ClassifyListParams;

public final class Main {
    private Main() {}

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

        ClassifyListPage page = client.classify().list();
    }
}

{
  "items": [
    {
      "id": "id",
      "configuration": {
        "rules": [
          {
            "description": "contains invoice number, line items, and total amount",
            "type": "invoice"
          }
        ],
        "mode": "FAST",
        "parsing_configuration": {
          "lang": "en",
          "max_pages": 10,
          "target_pages": "1,3,5-7"
        }
      },
      "document_input_type": "url",
      "file_input": "file_input",
      "project_id": "project_id",
      "status": "PENDING",
      "user_id": "user_id",
      "configuration_id": "configuration_id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "error_message": "error_message",
      "parse_job_id": "parse_job_id",
      "result": {
        "confidence": 0,
        "reasoning": "reasoning",
        "type": "type"
      },
      "transaction_id": "transaction_id",
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}

Returns Examples

{
  "items": [
    {
      "id": "id",
      "configuration": {
        "rules": [
          {
            "description": "contains invoice number, line items, and total amount",
            "type": "invoice"
          }
        ],
        "mode": "FAST",
        "parsing_configuration": {
          "lang": "en",
          "max_pages": 10,
          "target_pages": "1,3,5-7"
        }
      },
      "document_input_type": "url",
      "file_input": "file_input",
      "project_id": "project_id",
      "status": "PENDING",
      "user_id": "user_id",
      "configuration_id": "configuration_id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "error_message": "error_message",
      "parse_job_id": "parse_job_id",
      "result": {
        "confidence": 0,
        "reasoning": "reasoning",
        "type": "type"
      },
      "transaction_id": "transaction_id",
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}