---
title: "List available evaluators"
method: GET
path: "/org/evals/evaluators"
tags: ["Evals"]
---

# List available evaluators

`GET /org/evals/evaluators`

## Request

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

Returns the evaluators your organization can run, each with the subject types it accepts and descriptors for the metrics it reports, so results can be rendered without knowing an evaluator in advance.

## Response `200`

The available evaluators.

- EvaluatorListResponse: The evaluators available to your organization.
  - `items` Evaluator[], required
    - `key` string, required: The identifier to pass as `evaluator` on a trigger.
    - `display_name` string, required
    - `description` string: What the evaluator checks.
    - `evaluation_unit` string, required: What one claim row represents — `claim` for `kb_accuracy`, `rule` for `brand_alignment`.
    - `scope` string, required: `builtin` for the evaluators Senso provides to every organization.
    - `latest_version` string: The version a trigger uses when none is pinned.
    - `subjects` string[]: The subject types this evaluator accepts.
    - `metrics` EvaluatorMetricDescriptor[]: Descriptors for the metrics the evaluator reports, so score cards can be rendered generically.
      - `key` string, required: The metric's key in a run's `metrics`.
      - `type` string, required: The metric's value type, `number` or `enum`.
      - `range` number[]: For numbers, the minimum and maximum possible value.
      - `bands` object: For banded numbers, the minimum value for each band: at or above `green` is green, at or above `yellow` is yellow, below that is red.
      - `values` string[]: For enums, the possible values.
      - `description` string
      - `modes` string[]: Present when the metric is only reported for some subject types.
  - `total` integer, required
  - `limit` integer, required: Equals `total` — the list is not paginated.
  - `offset` integer, required: Always 0.

## Other responses

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