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

> Get an agent evaluation conversation to inspect one test attempt’s transcript, judgement, extracted fields, and available recording or latency data.

Read only

Get an agent evaluation conversation to inspect one test attempt’s transcript, judgement, extracted fields, and available recording or latency data.

## Get Agent Evaluation Conversation

Get the conversation ID from [Get Agent Evaluation Run](https://dialnexa.com/docs/api-reference/v1/eval-runs/get.md). Use the same agent and run IDs.

## Minimal request

No request body is needed. Supply all three IDs in the path.

## Evaluation conversation limits

Text runs do not exercise speech recognition or synthesis. An absent recording or audio measurement does not establish an audio-quality result. Use `error_message` to investigate an attempt that could not complete; distinguish the `error` outcome from a judged `fail`.

The original test name and type fall back to `Deleted test` and `simulation` only if the test record no longer exists. Review the transcript and result fields rather than inferring the original test from those fallback labels.

## Verify the result

A `200` response contains the conversation in `data`. Read `status`, `outcome`, `summary`, and `failure_reason` alongside `transcript`, `criteria`, `params`, `outcomes`, and `builtin`. Unfinished conversations can have no outcome and empty judgement arrays.

## Errors and recovery

`404` means the conversation does not belong to the supplied run and agent, or is not available in your workspace. Correct the IDs before retrying. 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 Run](https://dialnexa.com/docs/api-reference/v1/eval-runs/get.md)


## OpenAPI

````yaml GET /v1/agents/{id}/test-runs/{runId}/conversations/{conversationId}
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}/conversations/{conversationId}:
    get:
      tags:
        - Agent Evaluations
      summary: Get Agent Evaluation Conversation
      description: >-
        Returns one test conversation with its transcript, judgement, extracted
        fields and available recording and latency data. An unfinished
        conversation may have empty judgement arrays and no outcome.
      operationId: getAgentEvalConversation
      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.
        - name: conversationId
          in: path
          required: true
          schema:
            type: string
          description: Conversation ID from Get Agent Evaluation Run.
      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/AgentEvalConversation'
                  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:
    AgentEvalConversation:
      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
        test_name:
          type: string
        test_type:
          type: string
          enum:
            - next_reply
            - tool_call
            - simulation
        run_id:
          type: string
        transcript:
          type: array
          items:
            type: object
            additionalProperties: true
        criteria:
          type: array
          items:
            type: object
            additionalProperties: true
        params:
          type: array
          items:
            type: object
            additionalProperties: true
        outcomes:
          type: array
          items:
            type: object
            additionalProperties: true
        builtin:
          type: object
          additionalProperties: true
          nullable: true
        example_comparison:
          type: object
          additionalProperties: true
          nullable: true
        language_signals:
          type: array
          items:
            type: object
            additionalProperties: true
        extracted_fields:
          type: array
          items:
            type: object
            additionalProperties: true
        error_message:
          type: string
          nullable: true
        ended_reason:
          type: string
          nullable: true
        recording_url:
          type: string
          nullable: true
        latency_p50_ms:
          type: number
          nullable: true
        latency_p90_ms:
          type: number
          nullable: true
        judge_feedback:
          type: string
          nullable: true
          enum:
            - agree
            - disagree
            - null
      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.