---
title: "List judged claims"
method: GET
path: "/org/evals/claims"
tags: ["Evals"]
---

# List judged claims

`GET /org/evals/claims`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/evals/claims`
- Auth: API key in header `X-API-Key`

Returns one page of judged claims across your organization's runs, newest first — the gap report. Each claim carries its verdict, its classification bucket, and the evidence behind it. Filter by creation time, evaluator, subject type, or a single run.

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `evaluator` string
- `subject_type` string
- `run_id` string, uuid
- `limit` integer
- `offset` integer

## Response `200`

One page of judged claims.

- EvalClaimListResponse: One page of judged claims.
  - `items` EvalClaim[], required: The claims on this page, newest first.
    - `eval_claim_id` string, uuid, required
    - `eval_run_id` string, uuid, required
    - `evaluator_key` string, required
    - `subject_type` 'content' | 'content_generation_run_item' | 'builder_workspace_version' | 'question_run' | 'search_turn' | 'inline', required: The run's subject type.
    - `claim_key` string, required: The claim's identifier within its run (`c1`, `c2`, …). For `brand_alignment`, the writing rule that was graded.
    - `claim_text` string, required: The statement that was judged, in the judge's words. For a brand rule, the quoted passage that was graded, or `Rule N: <rule text>` when the reviewer quoted nothing.
    - `item_hash` string, required: A stable hash of the claim text, so the same statement can be recognised across runs.
    - `source_text` string: The sentence in the subject the claim was extracted from.
    - `kind` string: What sort of claim it is — normally `numeric`, `entity`, `procedural`, `modal`, or `other`. `kb_accuracy` only.
    - `about_brand` boolean: Whether the claim is about your organization. General knowledge is never checked against the knowledge base.
    - `verifiable` boolean: Whether a document could settle the claim. Subjective claims are excluded from scoring.
    - `verdict` string: The evaluator's own vocabulary. `kb_accuracy`: `verified`, `conflict`, `unsupported`, or `not_verifiable`. `brand_alignment`: `pass`, `partial`, `fail`, `not_applicable`, or `ungraded`. Absent when the claim was excluded before verification, or when the judge returned no verdict for a checkable claim — which scores as unsupported.
    - `passed` boolean, nullable, required: The normalized signal — `true` passed, `false` failed, `null` excluded from scoring rather than failing.
    - `bucket` string, required: The claim's classification. For knowledge-base checks on text and content: `general` (not about your brand), `subjective`, `grounded`, `contradicts_kb`, or `unsupported_by_kb`. For checks on cited answers: `ok`, `kb_gap`, `generation_error`, `kb_conflict_or_retrieval`, or `retrieval_miss`. For `brand_alignment` rows it carries the rule identifier.
    - `confidence` string: The judge's confidence in the verdict — normally `high`, `medium`, or `low`.
    - `reasoning` string: Why the judge reached the verdict.
    - `quote` string: The verbatim knowledge-base sentence the verdict rests on, checked against the retrieved text before the verdict was allowed to stand. Present on positive verdicts.
    - `grounding_failed` boolean: True when the verdict was demoted because its quote or citation was not in the retrieved text — the judge asserting support that was not there. Distinct from an honest `unsupported`.
    - `grounding_problem` string: What was wrong with the grounding, when `grounding_failed` is true.
    - `original_verdict` string: The verdict before demotion, when `grounding_failed` is true.
    - `suggested_fix` string: A concrete rewording for a failing claim or rule.
    - `evidence` EvalClaimEvidence[], nullable: The knowledge-base passages the verdict rests on.
      - `content_id` string, required: The content item the passage came from. An empty string marks a citation the judge gave that could not be matched to any retrieved passage; such verdicts are demoted (see `grounding_failed` on the claim).
      - `chunk_index` integer
      - `content_version_id` string, uuid
      - `relation` string, required: How the passage bears on the claim — normally `entails`, `contradicts`, or `related`.
    - `evidence_was_cited` boolean: Whether the evidence came from a source the judged answer itself cited. Only meaningful for cited-answer subjects; for text and content subjects it is `false` whenever evidence is present. Absent when the claim has no evidence.
    - `created_at` string, date-time, required
  - `total` integer, required: Total claims matching the filters, across all pages.
  - `limit` integer, required: The page size that was applied.
  - `offset` integer, required: The offset that was applied.

## Other responses

- `400`: The request was malformed — a bad path/query parameter or an invalid value.
- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.

---

[API](https://skmtc.dev/senso/apis/senso-org-api.md) - [All operations](https://skmtc.dev/senso/apis/senso-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/senso/apis/senso-org-api/revisions/d789b4fcbe84?raw)