List 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

GET

evaluation-summaries

List Evaluation Summaries

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

import requests

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

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/v1/evaluation-summaries/', 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-summaries/"

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

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

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

	fmt.Println(string(body))

}

{
  "results": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tested_by": "<string>",
      "status": "<string>",
      "created_at": 123,
      "reliability_score": 123,
      "security_score": 123,
      "safety_score": 123,
      "overall_score": 123,
      "pillar_details": {},
      "harness_names": [
        "<string>"
      ],
      "harness_type": "<string>",
      "resource_version": "<string>",
      "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "completed_at": 123,
      "request_params": {}
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

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

Query Parameters

team_id

string<uuid>

required

Team ID to list summaries for

agent_id

string<uuid> | null

Filter by agent ID

status

enum<string> | null

Filter by status (running, completed, failed, cancelled) Statuses for an evaluation run (mirrors the workflow lifecycle).

Available options:

running,

completed,

failed,

cancelled

harness_type

enum<string> | null

Filter by harness type (standard or custom)

Available options:

standard,

custom

tested_by

enum<string> | null

Filter by tool that ran the evaluation Tools that can produce evaluation results.

Available options:

diamond,

promptfoo,

garak,

pyrit

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 a paginated list of evaluation summaries.

results

EvaluationSummaryResponse · object[]

required

Hide child attributes

results.id

string<uuid>

required

results.team_id

string<uuid>

required

results.agent_id

string<uuid>

required

results.tested_by

string

required

results.status

string

required

results.created_at

integer

required

results.reliability_score

number | null

results.security_score

number | null

results.safety_score

number | null

results.overall_score

number | null

results.pillar_details

Pillar Details · object

results.harness_names

string[]

results.harness_type

string | null

results.resource_version

string | null

results.created_by

string<uuid> | null

results.completed_at

integer | null

results.request_params

Request Params · object | null

total

integer

required

limit

integer

required

offset

integer

required

Last modified on April 21, 2026

List Latest Evaluation Summaries By AgentReturn the latest completed evaluation summary per agent for the team. Uses server-side grouping (one row per agent_id with max completed_at). No pagination; returns at most one summary per agent that has a completed evaluation.

⌘I

List Evaluation Summaries

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

import requests

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

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/v1/evaluation-summaries/', 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-summaries/"

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

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

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

	fmt.Println(string(body))

}

{
  "results": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tested_by": "<string>",
      "status": "<string>",
      "created_at": 123,
      "reliability_score": 123,
      "security_score": 123,
      "safety_score": 123,
      "overall_score": 123,
      "pillar_details": {},
      "harness_names": [
        "<string>"
      ],
      "harness_type": "<string>",
      "resource_version": "<string>",
      "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "completed_at": 123,
      "request_params": {}
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

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

Get Started

Evaluate Agents

Protect Agents

Reference

List Evaluation Summaries

Query Parameters

Response