> ## 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.

# Get Agent Evaluation Run

> Get an agent evaluation run to inspect its current progress, result counters, insights, and conversation IDs.

Read only

Get an agent evaluation run to inspect its current progress, result counters, insights, and conversation IDs. Poll this operation after starting a run.

## Get Agent Evaluation Run

Use the run ID returned by [Start Agent Evaluation Run](https://dialnexa.com/docs/api-reference/v1/eval-runs/create.md) or [List Agent Evaluation Runs](https://dialnexa.com/docs/api-reference/v1/eval-runs/list.md).

## Minimal request

No request body is needed. Supply the agent ID and run ID.

## Evaluation run statuses

| Status | Meaning | What to do |
| - | - | - |
| `queued` | Test conversations are waiting to start. | Continue polling. |
| `running` | The run is in progress. | Review conversation progress and continue polling. |
| `completed` | The run has finished. | Check passed, failed, errored and individual outcomes. Completion alone is not a pass. |
| `cancelled` | Reserved. Runs currently end as `completed`; there is no cancel operation. | Treat it like `completed` if it appears. |

A conversation may be queued, calling, judging, scoring, or completed. While calling, its summary can include `turns` and `last_turn`; these are live indicators rather than a replacement for the full transcript. Insights have their own status: null until the run completes, then pending, ready, or failed. A completed run can still be waiting for insights.

## Verify the result

A `200` response contains the run in `data` and its `conversations` list. Use a conversation’s `id` to [inspect its transcript and judgement](https://dialnexa.com/docs/api-reference/v1/eval-runs/conversation.md).

## Errors and recovery

`404` means the agent or run is not available in this workspace. Check both IDs. Read requests are 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 Conversation](https://dialnexa.com/docs/api-reference/v1/eval-runs/conversation.md)


## OpenAPI

````yaml GET /v1/agents/{id}/test-runs/{runId}
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/{runId}:
    get:
      tags:
        - Agent Evaluations
      summary: Get Agent Evaluation Run
      description: >-
        Returns run progress, outcomes and conversation IDs. queued and running
        are non-final; completed and cancelled are terminal. Completion does not
        mean every test passed.
      operationId: getAgentEvalRun
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Agent ID from List Agents.
        - name: runId
          in: path
          required: true
          schema:
            type: string
          description: Run ID from Start or List Agent Evaluation Runs.
      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:
                    $ref: '#/components/schemas/AgentEvalRunDetail'
                  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:
    AgentEvalRunDetail:
      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
        conversations:
          type: array
          items:
            $ref: '#/components/schemas/AgentEvalConversationSummary'
      required:
        - id
        - agent_id
        - status
        - target
        - mode
        - llm
        - test_ids
        - total
    AgentEvalConversationSummary:
      type: object
      properties:
        id:
          type: string
        test_id:
          type: string
        attempt:
          type: integer
        language:
          type: object
          additionalProperties: true
          nullable: true
        llm:
          type: object
          additionalProperties: true
          nullable: true
        outcome:
          type: string
          nullable: true
          enum:
            - pass
            - fail
            - error
            - null
        failure_reason:
          type: string
          nullable: true
        status:
          type: string
          enum:
            - queued
            - calling
            - judging
            - scoring
            - completed
        summary:
          type: string
          nullable: true
        turns:
          type: integer
        last_turn:
          type: object
          additionalProperties: true
          nullable: true
      required:
        - id
        - test_id
        - attempt
        - status
  securitySchemes:
    bearer:
      scheme: bearer
      type: http

````

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