---
title: "List Evaluation Summaries"
method: GET
path: "/v1/evaluation-summaries/"
tags: ["Diamond", "evaluation-summaries"]
---

# List Evaluation Summaries

`GET /v1/evaluation-summaries/`

List evaluation summaries for a team with optional filters and pagination.

Args:
    team_id: Team ID to list summaries for (required)
    agent_id: Optional filter by agent ID
    status: Optional filter by status (running, completed, failed, cancelled)
    harness_type: Optional filter by harness type
    tested_by: Optional filter by evaluation tool
    limit: Max number of results (default 10, max 100)
    offset: Number of results to skip for paging
    claims: JWT claims with user and team info
    summary_repo: Evaluation summary repository

Returns:
    Paginated list of evaluation summaries with total count

Raises:
    HTTPException: 401 if unauthorized, 403 if no permission

## Query parameters

- `team_id` string, uuid, required — Team ID to list summaries for
- `agent_id` string, uuid, nullable — Filter by agent ID
- `status` 'running' | 'completed' | 'failed' | 'cancelled' — Statuses for an evaluation run (mirrors the workflow lifecycle).
- `harness_type` 'standard' | 'custom', nullable — Filter by harness type (standard or custom)
- `tested_by` 'diamond' | 'promptfoo' | 'garak' | 'pyrit' — Tools that can produce evaluation results.
- `limit` integer — Maximum number of results to return
- `offset` integer — Number of results to skip for paging

## Response `200`

Successful Response

- EvaluationSummaryListResponse — Response model for a paginated list of evaluation summaries.
  - `results` EvaluationSummaryResponse[], required
    - `id` string, uuid, required
    - `team_id` string, uuid, required
    - `agent_id` string, uuid, required
    - `tested_by` string, required
    - `status` string, required
    - `reliability_score` number, nullable
    - `security_score` number, nullable
    - `safety_score` number, nullable
    - `overall_score` number, nullable
    - `pillar_details` object
    - `harness_names` string[]
    - `harness_type` string, nullable
    - `resource_version` string, nullable
    - `created_by` string, uuid, nullable
    - `created_at` integer, required
    - `completed_at` integer, nullable
    - `request_params` object, nullable
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vijilai/apis/vijil-console-api-combined.md) · [All operations](https://skmtc.net/vijilai/apis/vijil-console-api-combined/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vijilai/vijil-console-api-combined/versions/a8b2ee2b2d06/schema)