List Workflow Runs

List all workflow execution runs with optional filtering.

GET /api/workflows/runs

List Workflow Runs

cURL

curl --request GET \
  --url https://encrata.com/api/workflows/runs \
  --header 'Authorization: Bearer <token>'

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

Status	Description
queued	Waiting to be picked up by the executor
running	Currently executing steps
completed	All steps finished successfully
failed	One or more steps failed
cancelled	Manually cancelled