For the complete documentation index, see llms.txt. This page is also available as Markdown.

GET /v2/evals/evaluators/{evaluator_id}

Get Evaluator

get

Read an evaluator with its current version.

How to use

Read the evaluator and its current configuration version before using its ID in an experiment or monitor. Verify whether it expects reference output.

Authentication and permissions

Required permissions: evals.read. Resource and owner access checks also apply.

Authorizations
AuthorizationstringRequired

Personal API key (sk_...) or supported user access JWT. See Authentication and authorization for endpoint restrictions and scopes. Use exactly one Authorization header.

Path parameters
evaluator_idstring · uuidRequired
Responses
200

Successful Response

application/json
response_codestring · nullableOptional

Machine-readable response code, when provided.

get/v2/evals/evaluators/{evaluator_id}
curl
curl --fail-with-body -sS \
  "$STACKAI_BASE_URL/v2/evals/evaluators/${EVALUATOR_ID}" \
  -H "Authorization: Bearer $STACKAI_API_KEY"
{
  "response_code": "text",
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "data": {
    "evaluator_id": "123e4567-e89b-12d3-a456-426614174000",
    "project_id": "text",
    "name": "text",
    "description": "text",
    "evaluator_type": "llm_judge",
    "version_number": 1,
    "node_contract": {
      "input_kind": "start_node",
      "input_keys": [
        "text"
      ],
      "output_node_ids": [
        "text"
      ]
    },
    "config": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "score_kind": "numeric",
    "uses_input": true,
    "uses_expected_output": true,
    "judge_provider": "text",
    "judge_model_id": "text",
    "created_by": "123e4567-e89b-12d3-a456-426614174000",
    "updated_by": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z"
  }
}

Last updated

Was this helpful?