API Reference
Hanzo Evals API
LLM evaluation for Hanzo Cloud — the `/v1/evals/*` surface served by the
LLM evaluation for Hanzo Cloud — the /v1/evals/* surface served by the
Hanzo Evals API · Guide & examples → · All API references →
| Base URL | https://api.hanzo.ai |
| Version | 1.0.0 |
| Operations | 6 |
| Guide | Hanzo Evals API guide |
Authentication
bearerAuth— HTTP bearer
All Hanzo APIs share one bearer credential and common error and pagination conventions. See API conventions.
curl -H "Authorization: Bearer $HANZO_API_KEY" https://api.hanzo.aiEndpoints
Datasets
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/evals/datasets | Create a dataset |
POST | /v1/evals/dataset-items | Add an item (input + optional expected output) to a dataset |
Evaluators
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/evals/evaluators | Register an evaluator (pre-built metric or custom rubric) |
Runs
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/evals/health | Health check |
POST | /v1/evals/runs | Run a dataset against a model with an LLM-as-a-Judge |
Scores
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/evals/scores | List scores |
How is this guide?