Skip to main content
GET
/
api
/
workflows
/
runs
List Workflow Runs
curl --request GET \
  --url https://encrata.com/api/workflows/runs \
  --header 'Authorization: Bearer <token>'

Documentation Index

Fetch the complete documentation index at: https://docs.encrata.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

Requires a JWT token or API key in the Authorization header. 
Authorization: Bearer YOUR_TOKEN

​
Request

​
Query parameters

​
page
integer
Page number (default: 1).
​
limit
integer
Items per page (default: 20).
​
workflow_id
string
Filter runs by a specific workflow.

​
Example request

curl "https://encrata.com/api/workflows/runs?workflow_id=wf_abc123&limit=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

{
  "runs": [
    {
      "id": "run_def456",
      "workflow_id": "wf_abc123",
      "workflow_name": "Lead enrichment pipeline",
      "status": "completed",
      "steps_total": 3,
      "steps_completed": 3,
      "credits_used": 2,
      "started_at": "2026-06-01T10:00:00Z",
      "completed_at": "2026-06-01T10:00:05Z",
      "duration_ms": 5200
    }
  ],
  "total": 42,
  "page": 1
}

​
Run statuses

StatusDescription
queuedWaiting to be picked up by the executor
runningCurrently executing steps
completedAll steps finished successfully
failedOne or more steps failed
cancelledManually cancelled