Is the judges your org has defined, each with its judge model, criteria and the…
Is the judges your org has defined, each with its judge model, criteria and the score name it writes under.
GET /v1/eval/evaluators
| Address | https://api.hanzo.ai/v1/eval/evaluators |
| Method | GET |
| Operation | get_eval_evaluators |
| Auth | Authorization: Bearer $HANZO_API_KEY |
Is the judges your org has defined, each with its judge model, criteria and the score name it writes under.
Requires a validated principal; 403 without one, and the listing is filtered on the validated org.
Request
1 field.
| Field | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer | — | Limit caps the rows returned. It defaults to 100 and is capped at 500; a non-positive or unparseable value falls back to the default rather than failing,… |
Response
| Status | Body | Meaning |
|---|---|---|
200 | evaluatorList | ok |
200 body — 7 fields.
| Field | In | Type | Always | Description |
|---|---|---|---|---|
data | body | evaluatorView[] | — | Data is the caller org's judges, bounded by limit. |
data[].createdAt | body | string | — | CreatedAt is when the judge was first defined. |
data[].criteria | body | string | — | Criteria is the written standard the judge applies. |
data[].model | body | string | — | Model is the model that does the grading. |
data[].name | body | string | — | Name is the judge's org-unique handle. |
data[].scoreName | body | string | — | ScoreName is the name the resulting scores are filed under. |
data[].updatedAt | body | string | — | UpdatedAt is when it last changed. |
Failure carries the platform error shape — see Errors.
Examples
hanzo evals evaluators getimport { Configuration, EvalApi } from 'hanzoai';
const api = new EvalApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getEvalEvaluators();from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import EvalApi
client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = EvalApi(client).get_eval_evaluators()cfg := cloud.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := cloud.NewAPIClient(cfg)
resp, _, err := client.EvalAPI.GetEvalEvaluators(context.Background()).Execute()
if err != nil {
return err
}use hanzo_cloud::apis::{configuration::Configuration, eval_api};
let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();
let result = eval_api::get_eval_evaluators(&cfg, Default::default()).await?;import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.EvalApi;
ApiClient client = new ApiClient();
client.setRequestInterceptor(b -> b.header("Authorization", "Bearer " + System.getenv("HANZO_API_KEY")));
var result = new EvalApi(client).getEvalEvaluators();The method above is the one at the current release of the document. [email protected] (npm) and [email protected] (PyPI) were generated from an earlier release, where this operation carried a different id, so it spells the method differently — regenerating the clients is what makes the two agree. SDKs →
curl https://api.hanzo.ai/v1/eval/evaluators \
-H "Authorization: Bearer $HANZO_API_KEY"The door reaches eval through the evals tool, which names its 16 operations with its own verbs — this one among them, under a name only the door declares. describe explains any of them:
curl -X POST https://api.hanzo.ai/v1/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "describe",
"arguments": {
"op": "list_eval_datasets"
}
}
}'How is this guide?