---
title: "List Completed Evaluations"
method: GET
path: "/v1/evaluation-results/"
tags: ["Diamond", "evaluation-results"]
---

# List Completed Evaluations

`GET /v1/evaluation-results/`

List completed evaluations from S3 storage for a specific team.

This endpoint lists only completed evaluations that have results stored in S3.
It requires the team_id as a query parameter and respects permission checks.
Supports paging via limit (default 10) and offset.

Args:
    team_id: Team ID to list evaluations for (required query parameter)
    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
    diamond_domain: Diamond domain for listing evaluations (newest-first sort + paginate)
    agent_adapter: Agent registry adapter for looking up agent names

Returns:
    List of completed evaluations with evaluation_id, team_id, agent information, and total count

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

## Query parameters

- `team_id` string, uuid, required
- `limit` integer — Maximum number of results to return
- `offset` integer — Number of results to skip for paging

## Response `200`

Successful Response

- EvaluationListResponse — Response model for listing completed evaluations.
  - `results` EvaluationListItem[] — List of completed evaluations with results in S3 (current page)
    - `evaluation_id` string, uuid, required — Evaluation ID
    - `team_id` string, uuid, required — Team ID that owns this evaluation
    - `created_by` string, uuid, nullable — User ID who created this evaluation
    - `created_at` integer, nullable — Unix timestamp when the evaluation was created
    - `completed_at` integer, nullable — Unix timestamp when the evaluation completed (from S3 metadata, no file read)
    - `agent_id` string, uuid, nullable — Agent ID that was evaluated
    - `agent_name` string, nullable — Name of the agent that was evaluated
  - `total` integer, required — Total number of completed evaluations (before limit/offset)

## 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)