List Completed Evaluations

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

GET

evaluation-results

List Completed Evaluations

curl --request GET \
  --url https://api.example.com/v1/evaluation-results/

import requests

url = "https://api.example.com/v1/evaluation-results/"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/v1/evaluation-results/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/evaluation-results/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "total": 123,
  "results": [
    {
      "evaluation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": 123,
      "completed_at": 123,
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_name": "<string>"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Query Parameters

team_id

string<uuid>

required

limit

integer

default:10

Maximum number of results to return

Required range: 1 <= x <= 100

offset

integer

default:0

Number of results to skip for paging

Required range: x >= 0

Response

Successful Response

Response model for listing completed evaluations.

total

integer

required

Total number of completed evaluations (before limit/offset)

results

EvaluationListItem · object[]

List of completed evaluations with results in S3 (current page)

Hide child attributes

results.evaluation_id

string<uuid>

required

Evaluation ID

results.team_id

string<uuid>

required

Team ID that owns this evaluation

results.created_by

string<uuid> | null

User ID who created this evaluation

results.created_at

integer | null

Unix timestamp when the evaluation was created

results.completed_at

integer | null

Unix timestamp when the evaluation completed (from S3 metadata, no file read)

results.agent_id

string<uuid> | null

Agent ID that was evaluated

results.agent_name

string | null

Name of the agent that was evaluated

Last modified on April 21, 2026

Get Evaluation ResultsGet evaluation results from S3 storage. The results are saved to S3 after the evaluation job completes. This endpoint searches S3 directly (no repository dependency). Args: evaluation_id: UUID of the evaluation team_id: Team ID that owns this evaluation (required query parameter) claims: JWT claims with user and team info diamond_domain: Diamond domain orchestrator (not used, kept for API consistency) storage: Evaluation storage adapter Returns: Evaluation results as JSON Raises: HTTPException: 404 if not found, 403 if no permission

⌘I

List Completed Evaluations

curl --request GET \
  --url https://api.example.com/v1/evaluation-results/

import requests

url = "https://api.example.com/v1/evaluation-results/"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/v1/evaluation-results/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/evaluation-results/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "total": 123,
  "results": [
    {
      "evaluation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": 123,
      "completed_at": 123,
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_name": "<string>"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Get Started

Evaluate Agents

Protect Agents

Reference

List Completed Evaluations

Query Parameters

Response