curl "https://developer.encrata.com/api/workflows/runs/d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
run_id = "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f"
resp = requests.get(
f"https://developer.encrata.com/api/workflows/runs/{run_id}",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(resp.json())
const runId = "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f";
const resp = await fetch(
`https://developer.encrata.com/api/workflows/runs/${runId}`,
{ headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } },
);
const data = await resp.json();
{
"run": {
"id": "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f",
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"workflow_name": "Lead enrichment pipeline",
"status": "completed",
"trigger_data": { "email": "jane@company.com" },
"credits_used": 2,
"started_at": "2026-06-01T10:00:00Z",
"completed_at": "2026-06-01T10:00:05Z"
},
"steps": null
}
Workflows
Get Workflow Run
Get detailed run information including step-by-step results.
GET
/
api
/
workflows
/
runs
/
{id}
curl "https://developer.encrata.com/api/workflows/runs/d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
run_id = "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f"
resp = requests.get(
f"https://developer.encrata.com/api/workflows/runs/{run_id}",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(resp.json())
const runId = "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f";
const resp = await fetch(
`https://developer.encrata.com/api/workflows/runs/${runId}`,
{ headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } },
);
const data = await resp.json();
{
"run": {
"id": "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f",
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"workflow_name": "Lead enrichment pipeline",
"status": "completed",
"trigger_data": { "email": "jane@company.com" },
"credits_used": 2,
"started_at": "2026-06-01T10:00:00Z",
"completed_at": "2026-06-01T10:00:05Z"
},
"steps": null
}
Overview
Returns one run underrun. The response also includes steps, which is
currently null.
Authentication
Requires an API key in theAuthorization header.
Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Request
string
required
The run’s UUID. The route matches a UUID only - a non-UUID id returns
404.Example request
curl "https://developer.encrata.com/api/workflows/runs/d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
run_id = "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f"
resp = requests.get(
f"https://developer.encrata.com/api/workflows/runs/{run_id}",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(resp.json())
const runId = "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f";
const resp = await fetch(
`https://developer.encrata.com/api/workflows/runs/${runId}`,
{ headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } },
);
const data = await resp.json();
Response
object
The run itself.
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.object
The payload the run was triggered with. There is no
input field.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.null
Currently always
null.Known issue:
steps is null on every run. Use
GET /api/workflows/logs to inspect
execution logs.Errors
| Status | Cause |
|---|---|
401 | Missing or invalid API key |
404 | No such run, or the id is not a UUID |
429 | Rate limit exceeded. See Rate limits |
500 | Unexpected server failure |
curl "https://developer.encrata.com/api/workflows/runs/d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
run_id = "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f"
resp = requests.get(
f"https://developer.encrata.com/api/workflows/runs/{run_id}",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(resp.json())
const runId = "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f";
const resp = await fetch(
`https://developer.encrata.com/api/workflows/runs/${runId}`,
{ headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } },
);
const data = await resp.json();
{
"run": {
"id": "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f",
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"workflow_name": "Lead enrichment pipeline",
"status": "completed",
"trigger_data": { "email": "jane@company.com" },
"credits_used": 2,
"started_at": "2026-06-01T10:00:00Z",
"completed_at": "2026-06-01T10:00:05Z"
},
"steps": null
}
Next steps
- List workflow runs: Find more run ids.
- Workflows guide: Build and trigger workflows.
Was this page helpful?