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

# List timer jobs

`GET /agent-management/timer-jobs`

## Request

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

## Query parameters

- `id` string
- `scopeId` string
- `withoutScopeId` boolean
- `subScopeId` 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'

## Response `200`

Indicates the requested jobs were returned.

- DataResponseJobResponse
  - `data` JobResponse[]
    - `id` string
    - `url` string
    - `elementId` string
    - `elementName` string
    - `scopeId` string
    - `subScopeId` string
    - `scopeDefinitionId` string
    - `scopeType` 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-agent-engine-rest-api.md) - [All operations](https://skmtc.dev/flowable/apis/flowable-agent-engine-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flowable/apis/flowable-agent-engine-rest-api/revisions/54fc1189496f?raw)