---
title: "List of tasks"
method: GET
path: "/cmmn-runtime/tasks"
tags: ["Tasks"]
---

# List of tasks

`GET /cmmn-runtime/tasks`

## Request

- Base URL: `https://developer-docs.flowable.com/cmmn-api`
- URL: `https://developer-docs.flowable.com/cmmn-api/cmmn-runtime/tasks`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/flowable/apis/flowable-cmmn-rest-api/docs/cmmn-runtime/tasks/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

- `taskId` string
- `name` string
- `nameLike` string
- `nameLikeIgnoreCase` string
- `description` string
- `priority` string
- `minimumPriority` string
- `maximumPriority` string
- `assignee` string
- `assigneeLike` string
- `owner` string
- `ownerLike` string
- `unassigned` string
- `delegationState` string
- `candidateUser` string
- `candidateGroup` string
- `candidateGroups` string
- `involvedUser` string
- `taskDefinitionKey` string
- `taskDefinitionKeyLike` string
- `caseInstanceId` string
- `caseInstanceIdWithChildren` string
- `caseDefinitionId` string
- `caseDefinitionKey` string
- `caseDefinitionKeyLike` string
- `caseDefinitionKeyLikeIgnoreCase` string
- `planItemInstanceId` string
- `propagatedStageInstanceId` string
- `scopeId` string
- `scopeIds` string
- `withoutScopeId` boolean
- `subScopeId` string
- `scopeType` string
- `createdOn` string, date-time
- `createdBefore` string, date-time
- `createdAfter` string, date-time
- `dueOn` string, date-time
- `dueBefore` string, date-time
- `dueAfter` string, date-time
- `withoutDueDate` boolean
- `excludeSubTasks` boolean
- `active` boolean
- `includeTaskLocalVariables` boolean
- `includeProcessVariables` boolean
- `tenantId` string
- `tenantIdLike` string
- `withoutTenantId` boolean
- `withoutProcessInstanceId` boolean
- `candidateOrAssigned` string
- `category` string
- `categoryIn` string
- `categoryNotIn` string
- `withoutCategory` string
- `rootScopeId` string
- `parentScopeId` string

## Response `200`

Indicates request was successful and the tasks are returned

- DataResponseTaskResponse
  - `data` TaskResponse[]
    - `id` string
    - `url` string
    - `owner` string
    - `assignee` string
    - `delegationState` string: Delegation-state of the task, can be null, "pending" or "resolved".
    - `name` string
    - `description` string
    - `createTime` string, date-time
    - `dueDate` string, date-time
    - `priority` integer
    - `suspended` boolean
    - `claimTime` string
    - `taskDefinitionKey` string
    - `scopeDefinitionId` string
    - `scopeId` string
    - `subScopeId` string
    - `scopeType` string
    - `propagatedStageInstanceId` string
    - `tenantId` string
    - `category` string
    - `formKey` string
    - `caseInstanceId` string
    - `caseInstanceUrl` string
    - `caseDefinitionId` string
    - `caseDefinitionUrl` string
    - `parentTaskId` string
    - `parentTaskUrl` string
    - `executionId` string
    - `processInstanceId` string
    - `processDefinitionId` string
    - `variables` RestVariable[]
      - `name` string: Name of the variable
      - `type` string: Type of the variable.
      - `value` object: Value of the variable.
      - `valueUrl` string
      - `scope` string
  - `total` integer
  - `start` integer
  - `sort` string
  - `order` string
  - `size` integer

## Other responses

- `404`: Indicates a parameter was passed in the wrong format or that delegationState has an invalid value (other than pending and resolved). The status-message contains additional information.

---

[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)