from retab import Retab

client = Retab()

results = client.workflows.tests.results.list("wftestrun_q1z2")
for result in results.data:
    print(result.test_id, result.verdict)

{
  "data": [
    {
      "id": "wfnodetestrun_a",
      "run_id": "wftestrun_q1z2",
      "test_id": "wfnodetest_a",
      "target": { "type": "block", "block_id": "block_extract_invoice" },
      "lifecycle": { "status": "completed" },
      "timing": {
        "started_at": "2026-05-18T10:00:02Z",
        "completed_at": "2026-05-18T10:00:20Z",
        "duration_ms": 18221
      },
      "outputs": {
        "output-json-0": { "total": 1234.56, "vendor": { "name": "Acme Inc" } }
      },
      "assertion_result": {
        "assertion_id": "assert_xyz",
        "condition_kind": "equals",
        "status": "passed",
        "actual_value": 1234.56,
        "expected_value": 1234.56,
        "failure": null
      },
      "verdict": { "status": "passed" }
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Results

List Test Results

List workflow test results for a single run, page by page.

Pagination strategy: the parent workflow_test_runs.result_run_record_ids document already holds the ordered list of child record IDs. workflow_block_test_runs rows do not carry a run_id field (the relationship lives only on the parent), so a direct keyset query on the child collection is not possible without a schema change. We slice the parent’s ordered list to resolve cursors and then $in-query the child collection for only the requested page — preserving the run-time ordering encoded in the parent doc and avoiding a fan-out collection scan.

GET

workflows

tests

results

from retab import Retab

client = Retab()

results = client.workflows.tests.results.list("wftestrun_q1z2")
for result in results.data:
    print(result.test_id, result.verdict)

{
  "data": [
    {
      "id": "wfnodetestrun_a",
      "run_id": "wftestrun_q1z2",
      "test_id": "wfnodetest_a",
      "target": { "type": "block", "block_id": "block_extract_invoice" },
      "lifecycle": { "status": "completed" },
      "timing": {
        "started_at": "2026-05-18T10:00:02Z",
        "completed_at": "2026-05-18T10:00:20Z",
        "duration_ms": 18221
      },
      "outputs": {
        "output-json-0": { "total": 1234.56, "vendor": { "name": "Acme Inc" } }
      },
      "assertion_result": {
        "assertion_id": "assert_xyz",
        "condition_kind": "equals",
        "status": "passed",
        "actual_value": 1234.56,
        "expected_value": 1234.56,
        "failure": null
      },
      "verdict": { "status": "passed" }
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

List the test results produced by one workflow-test run. Filter by run_id; each result also has its own opaque id; use Get Test Run Result to refresh one row directly. The response uses the canonical Retab list envelope: { "data": [...], "list_metadata": { "before": null, "after": null } }.

from retab import Retab

client = Retab()

results = client.workflows.tests.results.list("wftestrun_q1z2")
for result in results.data:
    print(result.test_id, result.verdict)

{
  "data": [
    {
      "id": "wfnodetestrun_a",
      "run_id": "wftestrun_q1z2",
      "test_id": "wfnodetest_a",
      "target": { "type": "block", "block_id": "block_extract_invoice" },
      "lifecycle": { "status": "completed" },
      "timing": {
        "started_at": "2026-05-18T10:00:02Z",
        "completed_at": "2026-05-18T10:00:20Z",
        "duration_ms": 18221
      },
      "outputs": {
        "output-json-0": { "total": 1234.56, "vendor": { "name": "Acme Inc" } }
      },
      "assertion_result": {
        "assertion_id": "assert_xyz",
        "condition_kind": "equals",
        "status": "passed",
        "actual_value": 1234.56,
        "expected_value": 1234.56,
        "failure": null
      },
      "verdict": { "status": "passed" }
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Authorizations

Api-Key

string

header

required

Query Parameters

run_id

string

required

before

string | null

after

string | null

limit

integer

default:20

Required range: 1 <= x <= 100

order

enum<string>

default:desc

Available options:

asc,

desc

Response

Successful Response

data

WorkflowTestResult · object[]

required

Show child attributes

list_metadata

ListMetadata · object

required

Boundary resource IDs for page navigation.

Show child attributes

Cancel Workflow Test Run Get Test Run Result

Documentation Index

Authorizations

Query Parameters

Response