---
title: "List Evaluations For A Given Agent"
method: GET
path: "/v1/orchestrate/agent/{agent_id}/evaluations"
tags: ["Agent Evaluation"]
---

# List Evaluations For A Given Agent

`GET /v1/orchestrate/agent/{agent_id}/evaluations`

List evaluations for a given agent

## Path parameters

- `agent_id` string, uuid, required

## Query parameters

- `limit` integer — Limit the number of results returned
- `offset` integer — Skip the first N results
- `sortkey` 'executed_date' | 'number_of_test_cases' | 'executed_by'
- `sort` 'asc' | 'desc'

## Response `200`

Successful Response

- EvaluationListResponse
  - `total` integer, required — Total number of evaluations
  - `page` integer, required — Current page
  - `page_size` integer, required — Number of results per page
  - `evaluations` EvaluationResponse[], required — List of evaluations in this page
    - `id` string, nullable — Evaluation ID
    - `executed_date` string, required — Date evaluated
    - `evaluation_status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED' | 'FAILED', required
    - `number_of_test_cases` integer, required — Number of test cases
    - `executed_by` string, required — Run by user
    - `aggregate_metrices` EvaluationMetrics
      - `tool_quality` ToolQualityMetrics
        - `average` MetricDetail
          - `value` number, nullable
          - `status` string, nullable
        - `accuracy` MetricDetail
          - `value` number, nullable
          - `status` string, nullable
        - `relevance` MetricDetail
          - `value` number, nullable
          - `status` string, nullable
      - `answer_quality` AnswerQualityMetrics
        - `average` MetricDetail
          - `value` number, nullable
          - `status` string, nullable
        - `relevance` MetricDetail
          - `value` number, nullable
          - `status` string, nullable
        - `correctness` MetricDetail
          - `value` number, nullable
          - `status` string, nullable
        - `faithfulness` MetricDetail
          - `value` number, nullable
          - `status` string, nullable
      - `transaction_completion` TrasactionCompletionMetrics
        - `average` MetricDetail
          - `value` number, nullable
          - `status` string, nullable
        - `failed` integer, nullable
        - `success` integer, nullable
        - `total` integer, nullable
    - `agent_name` string, nullable — Name of the agent
    - `agent_description` string, nullable — Description of the agent
    - `agent_environment` EnvironmentSchema[], nullable — List of environments associated with the agent
      - `id` string, uuid, required — Unique identifier for the environment
      - `name` string, required — Name of the environment
      - `current_version` integer, nullable — current_version
      - `voice` object, nullable — Voice configuration for the environment
      - `enable_wxg_integration` string, nullable — Flag to enable/disable wxg integration
      - `wxg_metrics_url` string, nullable — URL to watsonx.governance metrics dashboard for this agent

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ibm/apis/wxo-server-api.md) · [All operations](https://skmtc.net/ibm/apis/wxo-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ibm/wxo-server-api/revisions/82c114c37196/schema)