Classify

List Classify Jobs

List classify jobs with optional filtering and pagination.

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

get/api/v2/classify

Query parameters

page_sizeinteger nullable

Number of items per page

page_tokenstring nullable

Token for pagination

status'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' nullable

Filter by job status

job_idsstring[] nullable

Filter by specific job IDs

project_idstring uuid nullable

organization_idstring uuid nullable

configuration_idstring nullable

Filter by configuration ID

Example:cfg-11111111-2222-3333-4444-555555555555

Filter by configuration ID

created_at_on_or_afterstring date-time nullable

Include items created at or after this timestamp (inclusive)

created_at_on_or_beforestring date-time nullable

Include items created at or before this timestamp (inclusive)

Cookies

sessionstring nullable

Response

Successful Response

next_page_tokenstring 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_sizeinteger 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.

Example response

{
  "items": [
    {
      "configuration": {
        "rules": [
          {
            "type": "invoice",
            "description": "contains invoice number, line items, and total amount"
          }
        ],
        "parsing_configuration": {
          "lang": "en",
          "target_pages": "1,3,5-7",
          "max_pages": 10
        }
      }
    }
  ]
}

Changes

Changed in 2 of the 33 revisions of this API.13

Jun 9, 2026b17341164de92See the full diff
- ○
  added the optional property detail/items/ctx to the response with the 422 status
  response-optional-property-added
- ○
  added the optional property detail/items/input to the response with the 422 status
  response-optional-property-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 1, 20267e0726654d2211See the full diff
- ▲
  removed the required property items/items/document_input_value from the response with the 200 status
  response-required-property-removed
- ○
  added the required property items/items/file_input to the response with the 200 status
  response-required-property-added

Full history