---
title: "Batch verdict matrix (summary + per-subject rows) for a batch_verdicts run"
method: GET
path: "/v1/runs/{runId}/verdicts"
tags: ["Apps"]
---

# Batch verdict matrix (summary + per-subject rows) for a batch_verdicts run

`GET /v1/runs/{runId}/verdicts`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/runs/{runId}/verdicts`
- Auth: HTTP bearer

SQL-aggregated summary (totals, per-rule tallies, top blockers) plus a filterable, cursor-paginated page of per-subject verdicts. 404 for runs that produced no verdict rows.

## Path parameters

- `runId` string, uuid, required

## Query parameters

- `rolled` 'passed' | 'failed' | 'indeterminate' | 'not_applicable'
- `auto` boolean
- `rule` string
- `status` 'passed' | 'failed' | 'indeterminate' | 'not_applicable'
- `limit` integer
- `cursor` string

## Response `200`

Verdict summary and one page of rows.

- object
  - `summary` object
    - `total` integer
    - `auto` integer
    - `by_outcome` object
    - `by_rule` object
    - `top_blockers` object[]
      - `cardId` string
      - `failed` integer
  - `verdicts` object[]
    - `subject_key` string
    - `subject_label` string, nullable: Subject label stored when the verdict was decided; for older rows without one, the readable label from the subject binding's data product (cleaned alias); null when neither resolves.
    - `subject_record_id` string, nullable: Anchor record id in the subject binding's data product — deep-links the product review; null when unresolvable.
    - `decided_at` string, date-time: When this verdict was decided.
    - `rolled_outcome` 'passed' | 'failed' | 'indeterminate' | 'not_applicable'
    - `auto` boolean
    - `substantive_passes` integer
    - `rule_outcomes` object
  - `next` string, nullable

## Other responses

- `404`: The requested resource was not found.
- `422`: Invalid filter combination.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)