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

# List timer jobs

`GET /cmmn-management/timer-jobs`

## Request

- Base URL: `https://developer-docs.flowable.com/cmmn-api`
- URL: `https://developer-docs.flowable.com/cmmn-api/cmmn-management/timer-jobs`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/flowable/apis/flowable-cmmn-rest-api/docs/cmmn-management/timer-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
- `caseInstanceId` string
- `withoutScopeId` boolean
- `planItemInstanceId` string
- `caseDefinitionId` string
- `scopeDefinitionId` string
- `scopeType` string
- `elementId` string
- `elementName` string
- `timersOnly` boolean
- `messagesOnly` boolean
- `withException` boolean
- `dueBefore` string, date-time
- `dueAfter` string, date-time
- `exceptionMessage` string
- `tenantId` string
- `tenantIdLike` string
- `withoutTenantId` boolean
- `locked` boolean
- `unlocked` boolean
- `withoutProcessInstanceId` boolean
- `sort` 'id' | 'dueDate' | 'executionId' | 'processInstanceId' | 'retries' | 'tenantId'
- `order` string
- `start` integer
- `size` integer

## Response `200`

Indicates the requested jobs were returned.

- DataResponseJobResponse
  - `data` JobResponse[]
    - `id` string
    - `url` string
    - `caseInstanceId` string
    - `caseInstanceUrl` string
    - `caseDefinitionId` string
    - `caseDefinitionUrl` string
    - `planItemInstanceId` string
    - `elementId` string
    - `elementName` string
    - `handlerType` string
    - `retries` integer
    - `exceptionMessage` string
    - `dueDate` string, date-time
    - `createTime` string, date-time
    - `lockOwner` string
    - `lockExpirationTime` string, date-time
    - `tenantId` string
  - `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 or the both 'messagesOnly' and 'timersOnly' are used as parameters. 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)