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 SlimTaskListItems 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
slimis 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 pagenextCursor(string): Cursor of the next page; missing on the last page
Example 200 answer:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/workflow/v1/instances' \
-H "Authorization: Bearer $ACCESS_TOKEN"