SEsenso
Evals

List eval runs

Returns one page of your organization's eval runs, newest first, with each run's status and headline metrics. The bulky payloads — the subject snapshot, claims, searches, and evidence — are left to the single-run read. Filter by creation time, evaluator, and subject type.

get/org/evals/runs

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.

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 eval runs.

totalinteger required

Total runs matching the filters, across all pages.

limitinteger required

The page size that was applied.

offsetinteger required

The offset that was applied.

Example response

{
  "items": [
    {
      "evaluator_version": "1.1"
    }
  ]
}

Changes

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