---
title: "List Executions"
method: GET
path: "/v1/executions"
tags: ["Executions API"]
---

# List Executions

`GET /v1/executions`

Use this endpoint to retrieve a paginated list of workflow executions. You can filter results by workflow ID or status.

## Query parameters

- `workflowId` string, uuid
- `status` 'pending' | 'running' | 'completed' | 'failed'
- `limit` integer
- `cursor` string
- `sortBy` 'startedAt' | 'completedAt'
- `sortOrder` 'ASC' | 'DESC'

## Response `200`

Indicates that the request was successful and the response contains the requested data.

- ExecutionListOutput
  - `hasMore` boolean — Indicates whether more pages are available.
  - `items` ExecutionStatusOutput[] — List of execution statuses in the current page.
    - `completedAt` string, date-time — Timestamp when the execution finished. Null if still running.
    - `currentStepNumber` integer — Number of the step currently being executed (1-indexed).
    - `errorMessage` string — Error message if the execution failed. Null on success.
    - `executionId` string, uuid — Unique identifier of the execution.
    - `startedAt` string, date-time — Timestamp when the execution started.
    - `status` 'pending' | 'running' | 'completed' | 'failed' — Current status: `pending` (queued), `running` (in progress), `completed` (success), or `failed` (error).
    - `totalSteps` integer — Total number of steps in the workflow.
    - `workflowId` string, uuid — ID of the workflow being executed.
  - `nextCursor` string — Cursor for the next page.

## Other responses

- `400` — Indicates that the request was malformed or contained invalid parameters.
- `500` — Indicates an unexpected internal error. If this persists, please contact support.

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)