list-workflow-runs

GET /api/workflows/{workflow_id}/runs returns the execution history for a single Workflow: status, outputs, credits charged, and per-step results for each run. Results are capped at the 50 most recent runs, ordered by created_at descending.

Endpoint

GET https://api.valendata.com/api/workflows/{workflow_id}/runs

Authentication

This endpoint requires a session token:

Authorization: Bearer YOUR_SESSION_TOKEN

Path Parameters

string

required

The UUID of the Workflow whose run history you want to retrieve.

Example Request

curl https://api.valendata.com/api/workflows/3f2a1bc4-e89b-12d3-a456-426614174000/runs \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

Response

Returns a flat JSON array of up to 50 WorkflowRun objects, most recent first.

WorkflowRun Object

string

Unique identifier for this run (plain UUID).

string

UUID of the Workflow that was executed.

string

completed, failed, or waiting_for_human.

object | null

The inputs passed into the first step of this run.

any | null

Output from the final step. null if the run failed.

string | null

Error message if the run failed, otherwise null.

float

Credits consumed across all steps in this run.

integer | null

Total wall-clock time in milliseconds.

string | null

ISO 8601 UTC timestamp of when execution began.

string | null

ISO 8601 UTC timestamp of when the run finished.

string

ISO 8601 UTC timestamp of when the run record was created.

array

Ordered step result objects. See the step result fields on POST /workflows/run for the full field list.

Example Response

[
  {
    "id": "a1b2c3d4-0001-0000-0000-000000000000",
    "workflow_id": "3f2a1bc4-e89b-12d3-a456-426614174000",
    "status": "completed",
    "inputs": { "target_url": "https://example.com/pricing" },
    "outputs": [{ "plan": "Pro", "price_usd": 80 }],
    "error": null,
    "credits_charged": 12.5,
    "execution_time_ms": 18400,
    "started_at": "2026-08-20T09:00:00Z",
    "completed_at": "2026-08-20T09:00:18Z",
    "created_at": "2026-08-20T09:00:00Z",
    "step_results": []
  }
]

Error Handling

HTTP Status	Meaning
`401`	Session token missing or expired.
`404`	Workflow not found or you don’t have access to it.
`500`	Internal error on Valendata’s side.

Overview

Skills

Workflows

Runs

list-workflow-runs

Endpoint

Authentication

Path Parameters

Example Request

Response

WorkflowRun Object

Example Response

Error Handling

​Endpoint

​Authentication

​Path Parameters

​Example Request

​Response

​WorkflowRun Object

​Example Response

​Error Handling

Endpoint

Authentication

Path Parameters

Example Request

Response

WorkflowRun Object

Example Response

Error Handling