v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB

Executions API

List Executions

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

get/v1/executions

Query parameters

workflowIdstring uuid

Filter results by a specific workflow ID.

status'pending' | 'running' | 'completed' | 'failed'

Filter results by status.

limitinteger

Maximum number of items to return per page. Defaults to 10. Must be between 1 and 100.

cursorstring

Cursor for pagination. Use the value from the nextCursor field in a previous response to retrieve the next page.

sortBy'startedAt' | 'completedAt'

Field to sort results by.

sortOrder'ASC' | 'DESC'

Sort direction. Use ASC for ascending or DESC for descending.

Response

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

hasMoreboolean

Indicates whether more pages are available.

nextCursorstring

Cursor for the next page.

Example response

{
  "items": [
    {
      "executionId": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
      "workflowId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "completed",
      "currentStepNumber": 1,
      "totalSteps": 1,
      "startedAt": "2026-03-17T14:35:00Z",
      "completedAt": "2026-03-17T14:35:00Z"
    }
  ],
  "nextCursor": "",
  "hasMore": false
}