---
title: "List Evaluations"
method: GET
path: "/felix/evaluations"
tags: ["felix"]
---

# List Evaluations

`GET /felix/evaluations`

List all evaluations for the authenticated user.

Returns model and benchmark evaluations with their metrics.
Used by the frontend to build the evaluations matrix view.

If ``project_id`` is the sentinel ``"default"``, returns only
evaluations whose ``project_id`` is null (the unallocated bucket).
If ``project_id`` is any other value, it must be a valid UUID and
the response includes evaluations for that project plus orphan
evaluations (legacy behavior). If ``model_id`` is provided, only
evaluations for that model are returned.

## Query parameters

- `project_id` string, nullable — Filter by project ID. Pass the literal value 'default' to return only orphan evaluations (project_id IS NULL). For real project UUIDs the response also includes orphans for backward compatibility.
- `model_id` string, nullable — Filter evaluations by the evaluated model's ID
- `limit` integer — Maximum evaluations to return in this page.
- `cursor` string, nullable — Opaque cursor returned by the previous page.

## Response `200`

Successful Response

- EvaluationListResponse — Response for listing evaluations
  - `success` boolean, required
  - `evaluations` EvaluationResponse[], required
    - `id` string, required
    - `user_id` string, required
    - `project_id` string, nullable
    - `model_id` string, required
    - `dataset_name` string, required
    - `dataset_version` string, required
    - `model_name` string, nullable
    - `f1_score` number, nullable
    - `precision_score` number, nullable
    - `recall_score` number, nullable
    - `accuracy` number, nullable
    - `validation_loss` number, nullable
    - `subset_accuracy` number, nullable
    - `hamming_loss` number, nullable
    - `bleu_score` number, nullable
    - `rouge_l_score` number, nullable
    - `total_tokens` integer, nullable
    - `total_cost_usd` number, nullable
    - `total_latency_ms` integer, nullable
    - `max_examples` integer, nullable
    - `max_tokens` integer, nullable
    - `seed` integer, nullable
    - `config` object, nullable
    - `status` string, required
    - `job_reference` string, nullable
    - `error_message` string, nullable
    - `error_count` integer, nullable
    - `error_sample` string, nullable
    - `sample_count` integer, nullable
    - `evaluation_time_ms` integer, nullable
    - `created_at` string, date-time, required
    - `completed_at` string, date-time, nullable
    - `failed_examples` object[], nullable
    - `predictions` object[], nullable
  - `count` integer, required
  - `next_cursor` string, nullable
  - `has_more` boolean

## Other responses

- `422` — Validation Error
- `503` — Evaluation listing dependency is temporarily unavailable.

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/revisions/31dfe831e079/schema)