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

# List Agent Evaluation Runs

> List agent evaluation runs to retrieve up to the 100 newest runs for an agent, including progress counters and insights status.

Read only

List agent evaluation runs to retrieve up to the 100 newest runs for an agent, including progress counters and insights status.

## List Agent Evaluation Runs

Use an agent ID from [List Agents](https://dialnexa.com/docs/api-reference/v1/agents/list.md). Runs are scoped to the agent’s workspace.

## Minimal request

No body or pagination query is required. Supply the agent ID in the path.

## Verify the result

A `200` response contains run summaries in `data`, newest first. Use a run’s `id` with [Get Agent Evaluation Run](https://dialnexa.com/docs/api-reference/v1/eval-runs/get.md) for conversation details.

## Errors and recovery

`404` means the agent is not available in your workspace. Correct the ID and retry. Listing is read only and safe to repeat.

Missing, expired, or invalid API credentials return `401`. See [API authentication](https://dialnexa.com/docs/api-reference/api-fundamentals.md#authenticate-dialnexa-api-requests).

## Related endpoints

* [List Agent Evaluation Tests](https://dialnexa.com/docs/api-reference/v1/eval-tests/list.md)
* [Create Agent Evaluation Test](https://dialnexa.com/docs/api-reference/v1/eval-tests/create.md)
* [Start Agent Evaluation Run](https://dialnexa.com/docs/api-reference/v1/eval-runs/create.md)
* [Get Agent Evaluation Run](https://dialnexa.com/docs/api-reference/v1/eval-runs/get.md)
* [Get Agent Evaluation Conversation](https://dialnexa.com/docs/api-reference/v1/eval-runs/conversation.md)


## OpenAPI

````yaml GET /v1/agents/{id}/test-runs
openapi: 3.0.0
info:
  title: DialNexa API
  description: Public `/v1` REST API for the DialNexa voice AI platform.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: Agents
  - name: Batch Calls
  - name: Calls
  - name: Knowledge Base
  - name: Languages
  - name: LLMs
  - name: Phone Numbers
  - name: Organization Folders
  - name: Transcribers
  - name: Webhooks
  - name: Voices
  - name: Workflows
  - name: Workflow Leads
  - name: Authentication
  - name: Agent Builder
  - name: Agent Evaluations
paths:
  /v1/agents/{id}/test-runs:
    get:
      tags:
        - Agent Evaluations
      summary: List Agent Evaluation Runs
      description: >-
        Returns up to the 100 newest evaluation runs for this agent, including
        progress counters and insights status.
      operationId: listAgentEvalRuns
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Agent ID from List Agents.
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - error
                  - statusCode
                  - message
                  - data
                  - timestamp
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  error:
                    type: boolean
                    enum:
                      - false
                  statusCode:
                    type: integer
                    example: 200
                  message:
                    type: string
                    example: Success
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/AgentEvalRun'
                  timestamp:
                    type: string
                    format: date-time
        '401':
          description: Missing, expired or invalid API key.
        '404':
          description: Agent, test, run or conversation was not found in this workspace.
      security:
        - bearer: []
components:
  schemas:
    AgentEvalRun:
      type: object
      properties:
        id:
          type: string
        agent_id:
          type: string
        status:
          type: string
          enum:
            - queued
            - running
            - completed
            - cancelled
        target:
          type: string
          enum:
            - draft
            - published
        version_number:
          type: integer
        trigger:
          type: string
          enum:
            - manual
            - pre_publish
        repeat:
          type: integer
        mode:
          type: string
          enum:
            - text
            - voice
        llm:
          type: string
          enum:
            - primary
            - secondary
            - both
        test_ids:
          type: array
          items:
            type: string
        passed:
          type: integer
        failed:
          type: integer
        errored:
          type: integer
        total:
          type: integer
        cost_inr:
          type: number
          nullable: true
        duration_ms:
          type: integer
          nullable: true
        insights:
          type: object
          additionalProperties: true
          nullable: true
        insights_status:
          type: string
          nullable: true
          enum:
            - pending
            - ready
            - failed
            - null
        created_by_name:
          type: string
          nullable: true
        created_at:
          type: string
          format: date-time
        finished_at:
          type: string
          format: date-time
          nullable: true
      required:
        - id
        - agent_id
        - status
        - target
        - mode
        - llm
        - test_ids
        - total
  securitySchemes:
    bearer:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.