> ## Documentation Index
> Fetch the complete documentation index at: https://docs.collab-kit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Executions

> View the execution log for a workflow.

Retrieve the execution history for a specific workflow, including status, duration, and results.

## Endpoint

```
GET /v1/accounts/:accountId/workflows/:id/executions
```

## Authentication

**Bearer token** required.

## Path Parameters

<ParamField path="id" type="string" required>
  The workflow's unique ID.
</ParamField>

## Query Parameters

<ParamField query="limit" type="number" default="50">
  Number of executions to return. Maximum `100`.
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of executions to skip.
</ParamField>

## Response

<ResponseField name="executions" type="WorkflowExecution[]">
  Array of execution log entries. See [`WorkflowExecution`](/types/workflows#workflowexecution).
</ResponseField>

<ResponseField name="total" type="number">
  Total number of executions.
</ResponseField>

<ResponseField name="limit" type="number">
  The limit used.
</ResponseField>

<ResponseField name="offset" type="number">
  The offset used.
</ResponseField>

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl "https://api.collab-kit.com/v1/accounts/${ACCOUNT_ID}/workflows/wf_abc123/executions?limit=10" \
    -H "Authorization: Bearer ${TOKEN}"
  ```

  ```typescript JavaScript theme={null}
  const res = await fetch(
    `https://api.collab-kit.com/v1/accounts/${accountId}/workflows/wf_abc123/executions?limit=10`,
    { headers: { 'Authorization': `Bearer ${token}` } }
  );
  const { data } = await res.json();
  ```
</CodeGroup>

```json Response theme={null}
{
  "type": "response",
  "success": true,
  "description": "Executions retrieved",
  "data": {
    "executions": [
      {
        "id": "exec_001",
        "workflow_id": "wf_abc123",
        "event": "participant.joined",
        "status": "success",
        "result": "{\"success\":true}",
        "duration_ms": 42,
        "created_at": "2026-05-29T10:06:00.000Z"
      },
      {
        "id": "exec_002",
        "workflow_id": "wf_abc123",
        "event": "participant.joined",
        "status": "failed",
        "result": "TypeError: Cannot read property 'name' of undefined",
        "duration_ms": 15,
        "created_at": "2026-05-29T10:08:00.000Z"
      }
    ],
    "total": 2,
    "limit": 10,
    "offset": 0
  },
  "error": null
}
```
