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

# List runs in a workspace

> List the runs of every workflow in a workspace, newest first.

> [!NOTE]
>
> This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](https://docs.nedzo.ai/api-reference/introduction.md#plan-access).

A run is one trip of one contact or event through a workflow. This lists the runs of every workflow in a workspace, newest first. Add `workflowId` to see one workflow.

## Query Parameters

**workspaceId** `string` *required*

The workspace. Required.

**workflowId** `string`

Only runs of this workflow.

**status** `string`

One of `running`, `waiting`, `completed`, `failed` or `cancelled`. `running` includes runs that have not started.

**limit** `integer` (default: 50)

How many to return, 1 to 100.

**offset** `integer` (default: 0)

How many to skip.

```bash cURL theme={null}
curl "https://api.nedzo.ai/v1/workflows/runs?workspaceId=223e4567-e89b-12d3-a456-426614174000&status=failed" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json Response theme={null}
{
  "items": [
    {
      "id": "623e4567-e89b-12d3-a456-426614174000",
      "workflowId": "123e4567-e89b-12d3-a456-426614174000",
      "workspaceId": "223e4567-e89b-12d3-a456-426614174000",
      "status": "failed",
      "triggerType": "contact_created",
      "isTest": false,
      "errorMessage": "This step could not finish.",
      "startedAt": "2026-10-11T09:00:00Z",
      "completedAt": "2026-10-11T09:00:04Z"
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0,
  "hasMore": false
}
```

A run's `status` is `pending`, `running`, `waiting`, `completed`, `failed` or `cancelled`.

A run's `triggerType` is what started it: `contact_created`, `contact_tagged`, `contact_tag_added`, `contact_tag_removed`, `call_completed`, `conversation_completed`, `conversation_started`, `contact_replied`, `webhook`, `schedule`, `pipedrive_person_updated`, `manual` for a contact you enrolled, or `test` for a test run from the dashboard.

## Errors

| Status | When |
| - | - |
| `400` | A query parameter is wrong, or `workspaceId` is missing. |
| `402` | The account has no plan, or its subscription is not active. |
| `403` | Your plan is not VIP. |
| `404` | The workspace is not in this key's scope. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.