Which scope does this need?

results:read. A token without it gets 403 with requiredScope in the body. GET /me shows a token's scopes.

Are responses cached?

No. Every response is Cache-Control: no-store, so what you read is current.

API Reference / List workflow runs

List workflow runs

Q: How do I tie a lead back to the run that found it?

Every lead and contact carries workflowRunId: the workflow run that created it, or null when it was created outside a workflow (for example in chat) or before 2026-10-02. A run that saves a company again does not take it over, so each lead counts once. A later run is credited with new people it adds to that company: the company appears in that run's list with runCreatedLead: false and only the new people in runContactIds.

GET/api/v1/workflows/{id}/runs

Run history for one workflow, newest first, with per-step outcomes.

Last updated 10 October 2026

curl -H "Authorization: Bearer $REVNU_API_TOKEN" "https://revnu.com/api/v1/workflows/h97…/runs?limit=10"

Query

Param	Meaning
`limit`	1 to 50. Default 10.

Response

{ "runs": [run, …] }, newest first, each with its per-step outcomes. 404 for an unknown or another account's workflow.

A run's status is queued (started with POST /workflows/{id}/runs and not picked up yet), running, done, failed or abandoned (it never started or never reported back).

Each run has found: { leads, contacts }: how many leads and contacts this run created. Counting started on 2026-10-02, so runs before then show zero. List them with GET /leads?workflowRunId=<run id>.

Agents: this page is also markdown at /docs/workflow-runs.md, answers Accept: text/markdown, and is listed in /docs/llms.txt.

Frequently Asked Questions

Every lead and contact carries `workflowRunId`: the workflow run that created it, or `null` when it was created outside a workflow (for example in chat) or before 2026-10-02. A run that saves a company again does not take it over, so each lead counts once. A later run is credited with new people it adds to that company: the company appears in that run's list with `runCreatedLead: false` and only the new people in `runContactIds`.