## List all workflow instances of the tenant (workflow:admin)

`GET /api/workflow/v1/instances`

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

Every instance in every state, with overview field values, newest start first. Pages by cursor: pass
`nextCursor` as `cursor` until it is missing; no `total`.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `limit` | query | integer |  | Page size; another value than 1–500 is a `400 invalid` (default `100`; max 500) |
| `cursor` | query | string |  | `nextCursor` of the previous page (opaque); a foreign or altered cursor is a `400 invalid` |
| `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`) |

### Responses

- **200** Instances (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): Instances of the page
- `nextCursor` (string): Cursor of the next page; missing on the last page

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"
    }
  ],
  "nextCursor": "eyJzIjoiMjAyNi0xMS0xN1QwODo0MToxMloiLCJpZCI6IjNmOWMyYTFlIn0"
}
```

### Example request

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