---
title: "Every decision revision of one subject, oldest first"
method: GET
path: "/v1/apps/{id}/subjects/{key}/history"
tags: ["Apps"]
---

# Every decision revision of one subject, oldest first

`GET /v1/apps/{id}/subjects/{key}/history`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/apps/{id}/subjects/{key}/history`
- Auth: HTTP bearer

All verdict rows for the subject key across the app's runs, including dry and unsealed ones, each with the deciding run's App version, trigger and `sealed` flag. Only sealed, non-dry rows can stand.

## Path parameters

- `id` string, uuid, required
- `key` string, required

## Response `200`

Revision history.

- object
  - `subject_key` string
  - `active_version` integer, nullable
  - `versions` object: Content hash and per-rule fingerprints for the active version and every version that decided an entry.
  - `entries` object[]
    - `first_blocking_card` string, nullable: Earliest failed or indeterminate card in the authored order of the version that decided this entry; with no deciding version row, ordered by status, then key.
    - `standing` boolean: True for exactly the entry that is the subject's standing decision (highest revision of a completed, non-dry, sealed run), false for every other entry and for all entries when no run qualifies.
    - `run_id` string, uuid
    - `app_version` integer, nullable
    - `app_version_hash` string, nullable
    - `decision_revision` integer, nullable
    - `decided_at` string, date-time
    - `trigger` object, nullable
    - `dry_run` boolean
    - `sealed` boolean
    - `rolled_outcome` string
    - `auto` boolean
    - `substantive_passes` integer
    - `subject_label` string, nullable
    - `rule_outcomes` object, nullable
    - `document_outcomes` object[], nullable
      - `filename` string, nullable

## Other responses

- `403`: Master view ('all') or missing workspace — a concrete tenant is required.
- `404`: The requested resource was not found.
- `501`: Batch verdicts are not available in this deployment.

---

[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)