Evals

List judged claims

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.

get/org/evals/claims

Request

  • Base URL
    https://apiv2.senso.ai/api/v1
  • Auth
    API key in header X-API-Key

Query parameters

fromstring date-time

Only items created at or after this instant, in RFC 3339 form (e.g. 2026-09-01T00:00:00Z). Any other format is a 400.

tostring date-time

Only items created before this instant (exclusive), in RFC 3339 form. Any other format is a 400.

evaluatorstring

Only items produced by this evaluator, by key (kb_accuracy or brand_alignment).

subject_typestring

Only items whose subject is of this type — inline for text supplied to POST /org/evals/text, content for saved content items. Other values belong to runs triggered elsewhere in Senso.

run_idstring uuid

Only claims from this run. Must be a UUID, otherwise a 400.

limitinteger

Page size (1–100). Defaults to 25. Values above 100 are clamped to 100; zero, negative, or non-numeric values fall back to the default.

offsetinteger

Number of items to skip. Defaults to 0; negative or non-numeric values fall back to 0.

Response

One page of judged claims.

totalinteger required

Total claims matching the filters, across all pages.

limitinteger required

The page size that was applied.

offsetinteger required

The offset that was applied.

Example response

{
  "items": [
    {
      "claim_key": "c15"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.