> For the complete documentation index, see [llms.txt](https://docs.layerlens.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.layerlens.ai/more-in-this-section-9/evaluations.md).

# Evaluations

REST — Evaluations endpoints.

| Method | Path                              | Description     |
| ------ | --------------------------------- | --------------- |
| POST   | `/api/v1/evaluations`             | Create          |
| GET    | `/api/v1/evaluations/{id}`        | Get             |
| GET    | `/api/v1/evaluations`             | List            |
| GET    | `/api/v1/evaluations/{id}/rows`   | Per-row results |
| POST   | `/api/v1/evaluations/{id}/cancel` | Cancel running  |

## Create body

```json
{
 "model_id": "...",
 "benchmark_id": "...",
 "scorers": [...],
 "judges": [...]
}
```

## Status

`queued`, `running`, `completed`, `failed`, `cancelled`.

## Idempotency

POST `/api/v1/evaluations` accepts an `Idempotency-Key` header. Repeat requests with the same key within 24 hours return the original result rather than creating a duplicate evaluation.

```http
POST /api/v1/evaluations
X-API-Key: ll_...
Idempotency-Key: 8c3f2a1d-4f8a-4e2b-9c1e-7e5d6f8a9b0c
```

Use a UUID per logical request (e.g., one per CI run). Keys are scoped per-org and per-endpoint.

## See also

* [SDK: evaluations](/more-in-this-section-9/evaluations-1.md)