## List the open tasks assigned to the caller (tenant:access)

`GET /api/workflow/v1/tasks`

Module: Workflow · operationId: `listTasks` · Tag: Tasks · Auth: access token (`Authorization: Bearer <accessToken>`)

Instances in state `OPEN` or `RETRYING_SYNC` whose current step is assigned to the caller (the
step's user, a member of its group, or the recipient or sender of an open inquiry). Each item
carries the blueprint's overview fields with their values. Pages with `limit` and `offset`; `total` counts
all open tasks of the caller.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `limit` | query | integer |  | Page size; another value than 1–500 is a `400 invalid` (default `100`; max 500) |
| `offset` | query | integer |  | Number of items to skip; a negative value is a `400 invalid` (default `0`) |
| `slim` | query | string |  | `true` or `1`: return `SlimTaskListItem`s without data and history (one of `true`, `1`) |
| `format` | query | string |  | `slim`: same as `slim=true` (one of `slim`) |
| `slim_history` | query | string |  | `true` or `1`: blank the comments of notes and of history entries longer than 100 characters (one of `true`, `1`) |

### Responses

- **200** Tasks (slim items when `slim` is set) (`application/json`)
- **400** Error (`application/json`)
- **401** Missing or invalid token (`unauthorized`) (`application/json`)
- **403** Error (`application/json`)
- **500** Error (`application/json`)

Fields of the 200 answer:

- `items` (array of TaskListItem | SlimTaskListItem, required): Tasks of the page
- `total` (integer, required): Number of open tasks of the caller

Example 200 answer:

```json
{
  "items": [
    {
      "blueprint": {
        "id": "er-freigabe",
        "version": 3
      },
      "blueprintId": "er-freigabe",
      "blueprintVersion": 3,
      "claimedAt": "2026-11-17T09:05:40Z",
      "claimedBy": "christina.adler@muster-it.example",
      "currentStep": {
        "allowInquiry": true,
        "fields": [
          {
            "label": "Eingangsnr.",
            "name": "transactionNumber"
          },
          {
            "label": "Rechnungsnummer",
            "name": "externalTransactionNumber"
          },
          {
            "label": "Lieferant",
            "name": "partnerCompany"
          },
          {
            "editable": true,
            "label": "Fällig am",
            "name": "dueDate"
          },
          {
            "label": "Brutto",
            "name": "grossTotal"
          },
          {
            "label": "Bezeichnung",
            "name": "lines.name"
          },
          {
            "editable": true,
            "label": "Kostenstelle",
            "name": "lines.lineData.costCenter",
            "required": true
          },
          {
            "label": "Menge",
            "name": "lines.quantity"
          }
        ],
        "group": "4e7a1c2b-9f3d-4b8a-a6e1-5c0d2f8b3a71",
        "lines": {
          "allowDelete": true,
          "allowDuplicate": true
        },
        "name": "kontierung",
        "nextSteps": [
          {
            "color": "primary",
            "icon": "i-lucide-arrow-right",
            "label": "Weiter zur Freigabe",
            "step": "freigabe"
          },
          {
            "color": "error",
            "icon": "i-lucide-x-circle",
            "label": "Ablehnen",
            "step": "abgelehnt"
          }
        ],
        "notifyAssigneesByEmail": true,
        "stepType": "UserStep"
      },
      "customerId": {
        "customerId": "99999",
        "tenantName": "DEMO"
      },
      "guid": "3f9c2a1e-8b7d-4c6e-a5f4-1d2b3c4e5f60",
      "objectNumber": "ER-2026-00042",
      "objectType": "transaction",
      "overviewField1": {
        "label": "Lieferant",
        "name": "partnerCompany",
        "value": "Nordlicht IT-Distribution GmbH"
      },
      "overviewField2": {
        "label": "Brutto",
        "name": "grossTotal",
        "value": "6911.52"
      },
      "startTime": "2026-11-17T08:41:12Z",
      "workflowState": "OPEN"
    }
  ],
  "total": 1
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/workflow/v1/tasks' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
