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

# List Workflow Runs

> List the workflow runs on a lead

List every workflow run for one lead, most recently created first. Includes completed and cancelled workflow runs, so this is the lead's full history.

## Authentication

Requires the `x-api-key` header with a valid workspace API key.

## Query Parameters

**leadId** `string` *required*

The lead to list workflow runs for.

## Response

**success** `boolean`

Whether the request succeeded.

**workflowRuns** `array`

The workflow runs, most recently created first. Each entry has the same fields
as the `workflowRun` object returned by
[Get Workflow Run](https://docs.monumint.com/api-reference/workflow-runs/get-workflow-run.md).

## Errors

**400** `error`

`leadId` is missing.

**404** `error`

The `leadId` isn't a lead in your workspace.

```javascript Node.js theme={null}
const options = {
  method: "GET",
  headers: { "x-api-key": "<your-api-key>" },
};

fetch(
  "https://api-v2.getomni.ai/api/v1/workflow-runs?leadId=b1f0a790-201b-47e9-84ed-cc7eed1270c5",
  options,
)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err));
```

```python Python theme={null}
import requests

url = "https://api-v2.getomni.ai/api/v1/workflow-runs"
headers = {"x-api-key": "<your-api-key>"}
params = {"leadId": "b1f0a790-201b-47e9-84ed-cc7eed1270c5"}

response = requests.request("GET", url, headers=headers, params=params)
print(response.json())
```

```bash cURL theme={null}
curl --request GET \
  --url 'https://api-v2.getomni.ai/api/v1/workflow-runs?leadId=b1f0a790-201b-47e9-84ed-cc7eed1270c5' \
  --header 'x-api-key: <your-api-key>'
```

```json 200 theme={null}
{
  "success": true,
  "workflowRuns": [
    {
      "id": "5d8c1b2a-3e4f-5061-7283-94a5b6c7d8e9",
      "leadId": "b1f0a790-201b-47e9-84ed-cc7eed1270c5",
      "agentId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "workflowId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "externalId": null,
      "status": "ACTIVE",
      "createdAt": "2026-09-10T17:42:03.000Z",
      "completedAt": null,
      "cancelledAt": null
    }
  ]
}
```


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