> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tckg.factagora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Read verdicts

> GET /v1/verdicts. A target's verdicts as of an instant, with the latest one chosen by the server.

Verdicts are a resolver's judgements on a block (written through the `verdicts` field of [write memories](https://docs.tckg.factagora.com/api-reference/write-memories.md)). This read answers "what was the verdict on this block, as known at `as_of`": one item per requested `target_id`, with the latest verdict picked here so you do not sort them yourself.

The latest is the row with the greatest `(decided_at, captured_at)` among rows decided by `valid_at` (default `as_of`). When the top two tie on both, the server does not pick: `verdict` is null and `reason` is `unresolved_conflict`, with every row in `others`. A verdict written after `as_of` is hidden and counted in `masked.verdict`; one decided after `valid_at` is visible but reads `not_yet`.

## Query parameters

**target\_id** `string` *required*

Repeat it for several targets, 1 to 1000 per request. More is a `400` (`TCKG_TOO_MANY_IDS`); none is a `422` (the parameter is required).

**as\_of** `timestamp or date` *required*

Knowledge time. Only verdicts known by then. A date is widened to its end of day (UTC). Without it the request is a `400` (`TCKG_AS_OF_REQUIRED`).

**valid\_at** `timestamp`

Content time. A verdict decided after it reads `not_yet` and is not a candidate for `verdict`. Default `as_of`.

**space** `string`

Only targets that are blocks of this space. A target of another space answers `no_verdict`.

## Response

**items** `object[]`

One per distinct `target_id`, in id order: `target_id`, `verdict` (the latest row, or null), `others` (every other visible row, newest first, `not_yet` rows included), `reason` (null, `no_verdict` when nothing is visible, or `unresolved_conflict`).

**items\[].verdict** `object`

A row of `tckg.read_verdicts`: `id`, `target_id`, `tenant`, `value` and `outcome` as `{status, value}` (`status` is `known`, `not_yet` or `unknown`), `method`, `ruleset`, `resolver`, `decided_at`, `captured_at`.

**certificate** `object`

Scoped to `space`, like every read. `masked.verdict` counts the verdicts hidden because they were known after `as_of`.

```bash Request theme={null}
curl -s -G $TCKG/v1/verdicts --data-urlencode target_id=c1 --data-urlencode target_id=c9 \
  --data-urlencode as_of=2026-11-15 --data-urlencode valid_at=2024-04-01T00:00:00Z
```

```json Response theme={null}
{"items": [
  {"target_id": "c1",
   "verdict": {"id": "eb6271b5-...", "target_id": "c1", "tenant": "public",
               "value": {"status": "known", "value": "pending"}, "outcome": {"status": "known", "value": "undecidable"},
               "method": "price_check", "ruleset": "v1", "resolver": null,
               "decided_at": "2024-03-01T00:00:00+00:00", "captured_at": "2026-11-15T09:42:27+00:00"},
   "others": [{"id": "91fcbf9c-...", "target_id": "c1", "tenant": "public",
               "value": {"status": "not_yet", "value": null}, "outcome": {"status": "not_yet", "value": null},
               "method": "price_check", "ruleset": "v1", "resolver": null,
               "decided_at": "2024-06-01T00:00:00+00:00", "captured_at": "2026-11-15T09:42:27+00:00"}],
   "reason": null},
  {"target_id": "c9", "verdict": null, "others": [], "reason": "no_verdict"}],
 "masked": null,
 "certificate": {"as_of": "2026-11-16T00:00:00+00:00", "ruleset": "v1", "tx_as_of": "2026-11-15T09:42:28+00:00",
                 "admissible_max_ts": "2026-11-15T09:42:27+00:00"}}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.