---
title: "List Classify Jobs"
method: GET
path: "/api/v1/classifier/jobs"
tags: ["Classifier", "Beta", "Classifier"]
---

# List Classify Jobs

`GET /api/v1/classifier/jobs`

List classify jobs. Experimental: not production-ready and subject to change.

## Query parameters

- `project_id` string, uuid, nullable
- `organization_id` string, uuid, nullable
- `page_size` integer, nullable
- `page_token` string, nullable

## Cookies

- `session` string, nullable

## Response `200`

Successful Response

- PaginatedResponseClassifyJob
  - `items` ClassifyJob[], required — The list of items.
    - `status` 'PENDING' | 'SUCCESS' | 'ERROR' | 'PARTIAL_SUCCESS' | 'CANCELLED', required — Enum for representing the status of a job
    - `effective_at` string, date-time
    - `job_record_id` string, nullable — The job record ID associated with this status, if any.
    - `error_message` string, nullable — Error message for the latest job attempt, if any.
    - `id` string, uuid, required — Unique identifier
    - `created_at` string, date-time, nullable — Creation datetime
    - `updated_at` string, date-time, nullable — Update datetime
    - `rules` ClassifierRule[], required — The rules to classify the files
      - `type` string, required — The document type to assign when this rule matches (e.g., 'invoice', 'receipt', 'contract')
      - `description` string, required — Natural language description of what to classify. Be specific about the content characteristics that identify this document type.
    - `user_id` string, required — The ID of the user
    - `project_id` string, uuid, required — The ID of the project
    - `mode` 'FAST' | 'MULTIMODAL' — Supported classification execution modes.
    - `parsing_configuration` ClassifyParsingConfiguration — Parsing configuration for a classify job.
      - `lang` 'af' | 'az' | 'bs' | 'cs' | 'cy' | 'da' | 'de' | 'en' | 'es' | 'et' | 'fr' | 'ga' | 'hr' | 'hu' | 'id' | 'is' | 'it' | 'ku' | 'la' | 'lt' | 'lv' | 'mi' | 'ms' | 'mt' | 'nl' | 'no' | 'oc' | 'pi' | 'pl' | 'pt' | 'ro' | 'rs_latin' | 'sk' | 'sl' | 'sq' | 'sv' | 'sw' | 'tl' | 'tr' | 'uz' | 'vi' | 'ar' | 'fa' | 'ug' | 'ur' | 'bn' | 'as' | 'mni' | 'ru' | 'rs_cyrillic' | 'be' | 'bg' | 'uk' | 'mn' | 'abq' | 'ady' | 'kbd' | 'ava' | 'dar' | 'inh' | 'che' | 'lbe' | 'lez' | 'tab' | 'tjk' | 'hi' | 'mr' | 'ne' | 'bh' | 'mai' | 'ang' | 'bho' | 'mah' | 'sck' | 'new' | 'gom' | 'sa' | 'bgc' | 'th' | 'ch_sim' | 'ch_tra' | 'ja' | 'ko' | 'ta' | 'te' | 'kn' — Enum for representing the languages supported by the parser.
      - `max_pages` integer, nullable — The maximum number of pages to parse
      - `target_pages` integer[], nullable — The pages to target for parsing (0-indexed, so first page is at 0)
  - `next_page_token` string, nullable — A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.
  - `total_size` integer, nullable — The total number of items available. This is only populated when specifically requested. The value may be an estimate and can be used for display purposes only.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/run-llama/apis/llama-platform.md) · [All operations](https://skmtc.net/run-llama/apis/llama-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/run-llama/llama-platform/revisions/b17341164de9/schema)