curl "https://developer.encrata.com/api/workflows/runs?workflow_id=6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77&limit=20&offset=0" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
resp = requests.get(
"https://developer.encrata.com/api/workflows/runs",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
params={
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"limit": 20,
"offset": 0,
},
)
print(resp.json())
const url = new URL("https://developer.encrata.com/api/workflows/runs");
url.searchParams.set("workflow_id", "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77");
url.searchParams.set("limit", "20");
url.searchParams.set("offset", "0");
const resp = await fetch(url, {
headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" },
});
const data = await resp.json();
{
"runs": [
{
"id": "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f",
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"workflow_name": "Lead enrichment pipeline",
"status": "completed",
"credits_used": 2,
"started_at": "2026-06-01T10:00:00Z",
"completed_at": "2026-06-01T10:00:05Z"
}
],
"total": 42,
"limit": 20,
"offset": 0
}
Workflows
List Workflow Runs
List all workflow execution runs with optional filtering.
GET
/
api
/
workflows
/
runs
curl "https://developer.encrata.com/api/workflows/runs?workflow_id=6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77&limit=20&offset=0" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
resp = requests.get(
"https://developer.encrata.com/api/workflows/runs",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
params={
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"limit": 20,
"offset": 0,
},
)
print(resp.json())
const url = new URL("https://developer.encrata.com/api/workflows/runs");
url.searchParams.set("workflow_id", "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77");
url.searchParams.set("limit", "20");
url.searchParams.set("offset", "0");
const resp = await fetch(url, {
headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" },
});
const data = await resp.json();
{
"runs": [
{
"id": "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f",
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"workflow_name": "Lead enrichment pipeline",
"status": "completed",
"credits_used": 2,
"started_at": "2026-06-01T10:00:00Z",
"completed_at": "2026-06-01T10:00:05Z"
}
],
"total": 42,
"limit": 20,
"offset": 0
}
Overview
Returns workflow execution runs, newest first, with offset pagination. Use it to monitor a workflow’s history before fetching one run’s detail with Get workflow run.Authentication
Requires an API key in theAuthorization header.
Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Request
string
Filter runs to a single workflow, by its UUID. Omit to list runs across
every workflow on the account.
integer
default:"20"
Number of runs to return.
integer
default:"0"
Number of runs to skip. Pagination is offset-based. There is no
page
parameter.There is no status filter. Filter by
status in your own code after you read
the response.Example request
curl "https://developer.encrata.com/api/workflows/runs?workflow_id=6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77&limit=20&offset=0" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
resp = requests.get(
"https://developer.encrata.com/api/workflows/runs",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
params={
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"limit": 20,
"offset": 0,
},
)
print(resp.json())
const url = new URL("https://developer.encrata.com/api/workflows/runs");
url.searchParams.set("workflow_id", "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77");
url.searchParams.set("limit", "20");
url.searchParams.set("offset", "0");
const resp = await fetch(url, {
headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" },
});
const data = await resp.json();
Response
object[]
The matching runs.
Show run
Show run
string
The run’s UUID.
string
The UUID of the workflow that produced the run.
string
The workflow’s display name at the time of the run.
string
pending, running, completed, failed, or cancelled.integer
Credits consumed by the whole run.
string
ISO 8601 timestamp of when execution began.
string
ISO 8601 timestamp of when execution finished. Absent while the run is
pending or running.integer
Total number of runs matching the filter, ignoring
limit and offset.integer
The
limit that was applied.integer
The
offset that was applied.A run carries no
steps_total, steps_completed, or duration_ms. Per-step
detail lives on Get workflow run.Run statuses
| Status | Description |
|---|---|
pending | Accepted, waiting to be picked up by the executor |
running | Currently executing steps |
completed | All steps finished successfully |
failed | One or more steps failed |
cancelled | Cancelled before it finished |
There is no
queued status and no success status. Match on completed.Errors
| Status | Cause |
|---|---|
401 | Missing or invalid API key |
429 | Rate limit exceeded. See Rate limits |
500 | Unexpected server failure |
curl "https://developer.encrata.com/api/workflows/runs?workflow_id=6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77&limit=20&offset=0" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
resp = requests.get(
"https://developer.encrata.com/api/workflows/runs",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
params={
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"limit": 20,
"offset": 0,
},
)
print(resp.json())
const url = new URL("https://developer.encrata.com/api/workflows/runs");
url.searchParams.set("workflow_id", "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77");
url.searchParams.set("limit", "20");
url.searchParams.set("offset", "0");
const resp = await fetch(url, {
headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" },
});
const data = await resp.json();
{
"runs": [
{
"id": "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f",
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"workflow_name": "Lead enrichment pipeline",
"status": "completed",
"credits_used": 2,
"started_at": "2026-06-01T10:00:00Z",
"completed_at": "2026-06-01T10:00:05Z"
}
],
"total": 42,
"limit": 20,
"offset": 0
}
Next steps
- Get workflow run: Read one run’s per-step detail.
- List workflows: Find the
workflow_idto filter on.
Was this page helpful?