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));
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())
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>'
{
"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",
"status": "ACTIVE",
"createdAt": "2026-09-10T17:42:03.000Z",
"completedAt": null,
"cancelledAt": null
}
]
}
Workflow Runs
List Workflow Runs
List the workflow runs on a lead
GET
/
api
/
v1
/
workflow-runs
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));
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())
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>'
{
"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",
"status": "ACTIVE",
"createdAt": "2026-09-10T17:42:03.000Z",
"completedAt": null,
"cancelledAt": null
}
]
}
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 thex-api-key header with a valid workspace API key.
Query Parameters
string
required
The lead to list workflow runs for.
Response
boolean
Whether the request succeeded.
array
The workflow runs, most recently created first. Each entry has the same fields
as the
workflowRun object returned by
Get Workflow Run.Errors
error
leadId is missing.error
The
leadId isn’t a lead in your workspace.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));
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())
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>'
{
"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",
"status": "ACTIVE",
"createdAt": "2026-09-10T17:42:03.000Z",
"completedAt": null,
"cancelledAt": null
}
]
}