> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vijil.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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



## OpenAPI

````yaml /openapi/api.json get /v1/evaluation-summaries/
openapi: 3.1.0
info:
  title: Vijil Console API (Combined)
  description: Combined OpenAPI specification for all vijil-console microservices.
  version: 0.1.0
servers: []
security: []
tags:
  - name: Teams
    description: Authentication, users, and team management
  - name: Agent Environment
    description: Agent, persona, policy, and harness management
  - name: Diamond
    description: Evaluation management and report retrieval
  - name: Dome
    description: Protection, guardrails, and telemetry
  - name: Red Team
    description: Red team campaigns
paths:
  /v1/evaluation-summaries/:
    get:
      tags:
        - Diamond
        - evaluation-summaries
      summary: List Evaluation Summaries
      description: >-
        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
      operationId: list_evaluation_summaries_v1_evaluation_summaries__get
      parameters:
        - name: team_id
          in: query
          required: true
          schema:
            type: string
            format: uuid
            description: Team ID to list summaries for
            title: Team Id
          description: Team ID to list summaries for
        - name: agent_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            description: Filter by agent ID
            title: Agent Id
          description: Filter by agent ID
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/EvaluationStatus'
              - type: 'null'
            description: Filter by status (running, completed, failed, cancelled)
            title: Status
          description: Filter by status (running, completed, failed, cancelled)
        - name: harness_type
          in: query
          required: false
          schema:
            anyOf:
              - enum:
                  - standard
                  - custom
                type: string
              - type: 'null'
            description: Filter by harness type (standard or custom)
            title: Harness Type
          description: Filter by harness type (standard or custom)
        - name: tested_by
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/EvaluationTool'
              - type: 'null'
            description: Filter by tool that ran the evaluation
            title: Tested By
          description: Filter by tool that ran the evaluation
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Maximum number of results to return
            default: 10
            title: Limit
          description: Maximum number of results to return
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Number of results to skip for paging
            default: 0
            title: Offset
          description: Number of results to skip for paging
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvaluationSummaryListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    EvaluationStatus:
      type: string
      enum:
        - running
        - completed
        - failed
        - cancelled
      title: EvaluationStatus
      description: Statuses for an evaluation run (mirrors the workflow lifecycle).
    EvaluationTool:
      type: string
      enum:
        - diamond
        - promptfoo
        - garak
        - pyrit
      title: EvaluationTool
      description: Tools that can produce evaluation results.
    EvaluationSummaryListResponse:
      properties:
        results:
          items:
            $ref: '#/components/schemas/EvaluationSummaryResponse'
          type: array
          title: Results
        total:
          type: integer
          title: Total
        limit:
          type: integer
          title: Limit
        offset:
          type: integer
          title: Offset
      type: object
      required:
        - results
        - total
        - limit
        - offset
      title: EvaluationSummaryListResponse
      description: Response model for a paginated list of evaluation summaries.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    EvaluationSummaryResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        team_id:
          type: string
          format: uuid
          title: Team Id
        agent_id:
          type: string
          format: uuid
          title: Agent Id
        tested_by:
          type: string
          title: Tested By
        status:
          type: string
          title: Status
        reliability_score:
          anyOf:
            - type: number
            - type: 'null'
          title: Reliability Score
        security_score:
          anyOf:
            - type: number
            - type: 'null'
          title: Security Score
        safety_score:
          anyOf:
            - type: number
            - type: 'null'
          title: Safety Score
        overall_score:
          anyOf:
            - type: number
            - type: 'null'
          title: Overall Score
        pillar_details:
          additionalProperties: true
          type: object
          title: Pillar Details
        harness_names:
          items:
            type: string
          type: array
          title: Harness Names
        harness_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Harness Type
        resource_version:
          anyOf:
            - type: string
            - type: 'null'
          title: Resource Version
        created_by:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Created By
        created_at:
          type: integer
          title: Created At
        completed_at:
          anyOf:
            - type: integer
            - type: 'null'
          title: Completed At
        request_params:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Request Params
      type: object
      required:
        - id
        - team_id
        - agent_id
        - tested_by
        - status
        - created_at
      title: EvaluationSummaryResponse
      description: Response model for a single evaluation summary.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````