---
title: "List a configuration workflow's run history"
method: GET
path: "/api/south/{southId}/workflows/{workflowId}/runs"
tags: ["Configuration Workflows"]
---

# List a configuration workflow's run history

`GET /api/south/{southId}/workflows/{workflowId}/runs`

Lists a configuration workflow's run history, most recent first, optionally narrowed by any
combination of the filters below.

## Path parameters

- `southId` string, required
- `workflowId` string, required

## Query parameters

- `page` number, double
- `start` string — Represents an instant in time as an ISO 8601 string.
- `end` string — Represents an instant in time as an ISO 8601 string.
- `statuses` string
- `triggerTypes` string

## Response `200`

Paginated list of runs

- PageWorkflowRunDTO — Represents a paginated response containing an array of elements.
  - `content` WorkflowRunDTO[], required — The content of the page - an array of elements.
    - `discoveredCount` number, double, required
    - `eligibleCount` number, double, required
    - `createdCount` number, double, required
    - `updatedCount` number, double, required
    - `disabledCount` number, double, required
    - `pushedCount` number, double, required
    - `id` string, required
    - `workflowId` string, required
    - `triggerType` 'manual' | 'scheduled', required
    - `status` 'RUNNING' | 'ERRORED' | 'COMPLETED', required
    - `startedAt` string, required
    - `completedAt` string, nullable, required — Null while `status` is `RUNNING`.
    - `error` string, nullable, required — Set only when `status` is `ERRORED`.
    - `triggeredBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
  - `totalElements` number, double, required — The total number of elements across all pages.
  - `size` number, double, required — The size of the page, i.e., the maximum number of elements per page.
  - `number` number, double, required — The number of the current page, starting at 0.
  - `totalPages` number, double, required — The total number of pages (which can be 0 if there are no elements).

## Changes

- **2026-09-23** `92023a2f20ae` — 1 info
  - endpoint added
- **2026-09-21** `fbefadfe3be3` — 1 breaking
  - api path removed without deprecation
- **2026-09-21** `91dba375a461` — 1 info
  - endpoint added
- **2026-09-21** `52d824185a20` — 1 breaking
  - api path removed without deprecation
- **2026-09-10** `bb379d0410e7` — 1 breaking, 5 info
  - the `content/items/triggeredBy` response's property type changed from `string` to no type for status `200`
  - added the new optional `query` request parameter `end`
  - added the new optional `query` request parameter `start`
  - added the new optional `query` request parameter `statuses`
  - …2 more

[Full history](https://skmtc.dev/optimistiksas/apis/oibus-api/changes/api/south/:southId/workflows/:workflowId/runs/get.md)

---

[API](https://skmtc.dev/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.dev/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/optimistiksas/apis/oibus-api/revisions/a34e6afd34e1?raw)