KAkapso
Workflows

List workflow executions

Retrieve execution history for a workflow. Executions are returned in reverse chronological order (most recent first). Use query parameters to filter by status, time range, or cursor.

Response: Returns summary data (id, status, tracking_id, timestamps, workflow, current_step). Does not include execution_context or events. Use GET /workflow_executions/{id} to retrieve full execution details.

Pagination: Use limit, after, and before. Pagination cursors are returned in the paging object.

Common use cases:

  • Monitor active executions for a workflow
  • Review failed executions for debugging
  • Audit execution history over time
  • Find waiting executions that need user input
get/workflows/{workflow_id}/executions

Request

Query parameters

status'running' | 'waiting' | 'ended' | 'failed' | 'handoff'

Filter by execution status

waiting_reasonstring

Filter waiting executions by reason (e.g., 'wait_for_response', 'timeout')

created_afterstring date-time

Only return executions started on or after this timestamp

created_beforestring date-time

Only return executions started on or before this timestamp

whatsapp_conversation_idstring uuid

Filter by associated WhatsApp conversation

limitinteger

Maximum number of results per cursor-paginated page (default 20, max 100).

beforestring

Cursor for the previous page (Base64 encoded).

afterstring

Cursor for the next page (Base64 encoded).

Response

Executions retrieved successfully

Changes

No recorded changes to this operation across all 1 revision of this API.