---
title: "List history jobs"
method: GET
path: "/cmmn-management/history-jobs"
tags: ["Jobs"]
---

# List history jobs

`GET /cmmn-management/history-jobs`

## Request

- Base URL: `https://developer-docs.flowable.com/cmmn-api`
- URL: `https://developer-docs.flowable.com/cmmn-api/cmmn-management/history-jobs`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/flowable/apis/flowable-cmmn-rest-api/docs/cmmn-management/history-jobs/get.ts> (a function with typed inputs; its response is checked against the schema)

For all 'Like' parameters the '%' wildcard character must be URL-encoded as '%25' (for example '?nameLike=acme%25' to match names starting with 'acme').

## Query parameters

- `id` string
- `withException` boolean
- `exceptionMessage` string
- `scopeType` string
- `tenantId` string
- `tenantIdLike` string
- `withoutTenantId` boolean
- `lockOwner` string
- `locked` boolean
- `unlocked` boolean
- `sort` 'id' | 'retries' | 'tenantId'
- `order` string
- `start` integer
- `size` integer

## Response `200`

Indicates the requested jobs were returned.

- DataResponseHistoryJobResponse
  - `data` HistoryJobResponse[]
    - `id` string
    - `url` string
    - `scopeType` string
    - `retries` integer
    - `exceptionMessage` string
    - `jobHandlerType` string
    - `jobHandlerConfiguration` string
    - `advancedJobHandlerConfiguration` string
    - `tenantId` string
    - `customValues` string
    - `createTime` string, date-time
    - `lockOwner` string
    - `lockExpirationTime` string, date-time
  - `total` integer
  - `start` integer
  - `sort` string
  - `order` string
  - `size` integer

## Other responses

- `400`: Indicates an illegal value has been used in a url query parameter. Status description contains additional details about the error.

---

[API](https://skmtc.dev/flowable/apis/flowable-cmmn-rest-api.md) - [All operations](https://skmtc.dev/flowable/apis/flowable-cmmn-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flowable/apis/flowable-cmmn-rest-api/revisions/afdfa1fcacd0?raw)