GET /v2/evals/evaluators/{evaluator_id}
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.
Personal API key (sk_...) or supported user access JWT. See Authentication and authorization for endpoint restrictions and scopes. Use exactly one Authorization header.
Successful Response
Machine-readable response code, when provided.
Invalid request or pagination cursor
Missing or invalid credentials
Denied permission, project folder access, or API-key scope (meta.required_scope)
Resource not found in the caller's organization
Client error returned in the public API envelope
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?

