List Batch Jobs

List batch processing jobs with optional filtering.

Filter by directory_id, job_type, or status. Results are paginated with configurable limit and offset.

get/api/v1/beta/batch-processing

Query parameters

directory_idstring nullable

Filter by directory ID

job_type'parse' | 'extract' | 'classify'

Type of batch processing operation.

Filter by job type (PARSE, EXTRACT, CLASSIFY)

Status of a batch processing job.

Filter by job status (PENDING, RUNNING, COMPLETED, FAILED, CANCELLED)

limitinteger

Maximum number of jobs to return

offsetinteger

Number of jobs to skip for pagination

project_idstring uuid nullable

organization_idstring uuid nullable

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": [
    {
      "id": "bjb-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "project_id": "proj-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "directory_id": "dir-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
    }
  ]
}

Changes

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

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

Full history