# Get Agent Evaluation Run

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v2/agents/{agent_id}/evaluation-runs/{evaluation_public_id}:
    get:
      summary: Get Agent Evaluation Run
      deprecated: false
      description: >-
        Retrieve detailed information about a specific evaluation run linked to
        the agent, including query results and metrics.
      operationId: api_v2_agents_evaluation_runs_retrieve
      tags:
        - Agents/Evaluation Runs
        - Agents/Evaluation Runs
        - v2
      parameters:
        - name: agent_id
          in: path
          description: ID of the agent
          required: true
          example: 0
          schema:
            type: integer
        - name: evaluation_public_id
          in: path
          description: UUID of the evaluation run to retrieve
          required: true
          example: ''
          schema:
            type: string
        - name: Organization-Id
          in: header
          description: 'ID of the organization. Optional. '
          required: false
          example: 0
          schema:
            type: integer
        - name: Ocp-Apim-Subscription-Key
          in: header
          description: API KEY FOR EJENTO APIs
          required: true
          example: '{{your-api-key}}'
          schema:
            type: string
            default: '{{your-api-key}}'
        - name: Authorization
          in: header
          description: AUTH TOKEN
          example: Bearer {{your-access-token}}
          schema:
            type: string
            default: Bearer {{your-access-token}}
      responses:
        '200':
          description: Evaluation run retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentEvaluationRunDetailResponseSchema_V2'
          headers: {}
          x-apidog-name: OK
        '400':
          description: >-
            The `Organization-Id` header is not a positive integer, the URL path
            and `Organization-Id` name different organizations, or the request
            body's `organization_id` and `org_id` name different organizations.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    default: false
                  message:
                    type: string
                  data:
                    type: object
                    default: {}
                    x-apidog-orders: []
                    properties: {}
                    x-apidog-ignore-properties: []
                required:
                  - success
                  - message
                  - data
                x-apidog-orders:
                  - success
                  - message
                  - data
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Record Not Found
        '403':
          description: >-
            The subscription key belongs to a different organization than the
            one this request names, or you do not have access to the
            organization it names. An organization that does not exist returns
            the same response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    default: false
                  message:
                    type: string
                  data:
                    type: object
                    default: {}
                    x-apidog-orders: []
                    properties: {}
                    x-apidog-ignore-properties: []
                required:
                  - success
                  - message
                  - data
                x-apidog-orders:
                  - success
                  - message
                  - data
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Server Error
        '404':
          description: ''
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/AgentEvaluationRunDetail404ResponseSchema_V2
          headers: {}
          x-apidog-name: ''
        '500':
          description: ''
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/AgentEvaluationRunDetail500ResponseSchema_V2
          headers: {}
          x-apidog-name: ''
        '503':
          description: >-
            The organization for this request could not be verified. Try again
            later.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    default: false
                  message:
                    type: string
                  data:
                    type: object
                    default: {}
                    x-apidog-orders: []
                    properties: {}
                    x-apidog-ignore-properties: []
                required:
                  - success
                  - message
                  - data
                x-apidog-orders:
                  - success
                  - message
                  - data
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: ''
      security: []
      x-apidog-folder: Agents/Evaluation Runs
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/998119/apis/api-24930619-run
components:
  schemas:
    AgentEvaluationRunDetailResponseSchema_V2:
      type: object
      properties:
        message:
          type: string
        success:
          type: boolean
        data:
          $ref: '#/components/schemas/AgentEvaluationRunDetailResponse_V2'
      required:
        - message
        - success
        - data
      x-apidog-orders:
        - message
        - success
        - data
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    AgentEvaluationRunDetailResponse_V2:
      type: object
      description: Response serializer for retrieving a single evaluation run
      properties:
        bridge_id:
          type: integer
          description: ID of the bridge record
        id:
          type: integer
          description: Primary key ID from the Evaluation Service
          nullable: true
        evaluation_public_id:
          type: string
          format: uuid
          description: Public UUID of the evaluation run
        name:
          type: string
          description: Name of the evaluation run
          nullable: true
        status:
          type: string
          description: Status of the evaluation
        datasets:
          type: array
          items:
            $ref: '#/components/schemas/AgentEvaluationRunDatasetInfo_V2'
          description: Datasets used in this evaluation
          nullable: true
        metric_names:
          type: array
          items:
            type: string
          description: Metrics evaluated
          nullable: true
        scores:
          allOf:
            - &ref_0
              $ref: '#/components/schemas/AgentEvaluationRunScores_V2'
          description: Overall evaluation scores
          type: 'null'
        query_results:
          type: array
          items:
            $ref: '#/components/schemas/AgentEvaluationRunQueryResult_V2'
          description: Detailed results for each query
          nullable: true
        total_queries:
          type: integer
          description: Total number of queries
          nullable: true
        completed_queries:
          type: integer
          description: Number of completed queries
          nullable: true
        failed_queries:
          type: integer
          description: Number of failed queries
          nullable: true
        llm_config:
          allOf:
            - $ref: '#/components/schemas/AgentEvaluationRunLLMConfig_V2'
          description: LLM configuration used for this evaluation run
          type: 'null'
        prefix_prompt:
          type: string
          description: Prefix prompt used
          nullable: true
        model_deployment:
          type: string
          description: Model deployment identifier
          nullable: true
        custom_instructions:
          type: array
          items:
            type: string
          description: >-
            List of custom instruction strings that were applied during this
            evaluation run
          nullable: true
        source_enabled:
          type: boolean
          description: Whether sources were enabled
          nullable: true
        agent_chunk_count:
          type: integer
          description: Chunk count used
          nullable: true
        created_on:
          type: string
          format: date-time
          description: Timestamp when created
          nullable: true
        created_by:
          type: string
          description: Email of the creator
          nullable: true
        started_on:
          type: string
          format: date-time
          description: Timestamp when evaluation started
          nullable: true
        completed_on:
          type: string
          format: date-time
          description: Timestamp when completed
          nullable: true
        duration_seconds:
          type: number
          format: double
          description: Duration of evaluation in seconds
          nullable: true
        metadata:
          allOf:
            - $ref: '#/components/schemas/AgentEvaluationRunBridgeMetadata_V2'
          description: >-
            Bridge record metadata. Fields: original_run_id (int) — legacy
            source run ID; source (str) — record origin, valid values: 'api',
            'migration', 'legacy'; notes (str) — free-text annotation.
          type: 'null'
      required:
        - bridge_id
        - evaluation_public_id
        - status
      x-apidog-orders:
        - bridge_id
        - id
        - evaluation_public_id
        - name
        - status
        - datasets
        - metric_names
        - scores
        - query_results
        - total_queries
        - completed_queries
        - failed_queries
        - llm_config
        - prefix_prompt
        - model_deployment
        - custom_instructions
        - source_enabled
        - agent_chunk_count
        - created_on
        - created_by
        - started_on
        - completed_on
        - duration_seconds
        - metadata
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    AgentEvaluationRunBridgeMetadata_V2:
      type: object
      description: Optional metadata stored on the agent-evaluation run bridge record.
      properties:
        original_run_id:
          type: integer
          description: >-
            ID of the source legacy EvaluationRun (populated during migration
            from the old model)
          nullable: true
        source:
          type: string
          description: >-
            How this bridge record was created. Valid values: 'api',
            'migration', 'legacy'.
          nullable: true
        notes:
          type: string
          description: Free-text annotation for this link
          nullable: true
      x-apidog-orders:
        - original_run_id
        - source
        - notes
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    AgentEvaluationRunLLMConfig_V2:
      type: object
      description: >-
        LLM configuration for an evaluation run.

        Mirrors the fields of the LLMConfig model used by agents.

        All fields are optional — only the values you provide override the
        agent's defaults.
      properties:
        model_name:
          type: string
          description: Model name identifier
          nullable: true
        model_deployment:
          type: string
          description: Azure/custom deployment name for the model
          nullable: true
        model_provider:
          type: string
          description: 'LLM provider identifier. Default: ''azure_openai''.'
          nullable: true
        temperature:
          type: number
          format: double
          description: >-
            Sampling temperature (0.0–2.0). Lower values produce more
            deterministic output
          nullable: true
        max_tokens:
          type: integer
          description: Maximum number of tokens to generate
          nullable: true
        top_p:
          type: number
          format: double
          description: Top-p nucleus sampling parameter (0.0–1.0)
          nullable: true
        reasoning_effort:
          type: string
          description: >-
            Reasoning effort level for supported models. Valid values: 'low',
            'medium', 'high'
          nullable: true
        api_key:
          type: string
          description: API key override (optional; uses the agent's default key if omitted)
          nullable: true
        endpoint:
          type: string
          description: >-
            Endpoint URL override (optional; uses the agent's default endpoint
            if omitted)
          nullable: true
      x-apidog-orders:
        - model_name
        - model_deployment
        - model_provider
        - temperature
        - max_tokens
        - top_p
        - reasoning_effort
        - api_key
        - endpoint
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    AgentEvaluationRunQueryResult_V2:
      type: object
      description: Individual query result in evaluation
      properties:
        question:
          type: string
          description: The evaluation question
        expected_answer:
          type: string
          description: Expected answer
          nullable: true
        actual_answer:
          type: string
          description: Actual answer from the agent
          nullable: true
        scores:
          allOf:
            - *ref_0
          description: Scores for this specific query
          type: 'null'
        status:
          type: string
          description: Status of this query evaluation
          nullable: true
      required:
        - question
      x-apidog-orders:
        - question
        - expected_answer
        - actual_answer
        - scores
        - status
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    AgentEvaluationRunScores_V2:
      type: object
      description: Evaluation scores/metrics
      properties:
        answer_similarity:
          type: number
          format: double
          description: Answer similarity score
          nullable: true
        answer_relevancy:
          type: number
          format: double
          description: Answer relevancy score
          nullable: true
        faithfulness:
          type: number
          format: double
          description: Faithfulness score
          nullable: true
        context_recall:
          type: number
          format: double
          description: Context recall score
          nullable: true
        context_precision:
          type: number
          format: double
          description: Context precision score
          nullable: true
      x-apidog-orders:
        - answer_similarity
        - answer_relevancy
        - faithfulness
        - context_recall
        - context_precision
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    AgentEvaluationRunDatasetInfo_V2:
      type: object
      description: Dataset information in evaluation run details
      properties:
        dataset_public_id:
          type: string
          format: uuid
          description: UUID of the dataset
        name:
          type: string
          description: Name of the dataset
        questions_count:
          type: integer
          description: Number of questions in the dataset
          nullable: true
      required:
        - dataset_public_id
        - name
      x-apidog-orders:
        - dataset_public_id
        - name
        - questions_count
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    AgentEvaluationRunDetail404ResponseSchema_V2:
      type: object
      properties:
        success:
          type: boolean
          default: false
        message:
          type: string
          default: Agent or evaluation run not found
        data:
          type: object
          additionalProperties:
            type: string
          default: {}
          x-apidog-orders: []
          properties: {}
          x-apidog-ignore-properties: []
      x-apidog-orders:
        - success
        - message
        - data
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    AgentEvaluationRunDetail500ResponseSchema_V2:
      type: object
      properties:
        success:
          type: boolean
          default: false
        message:
          type: string
          default: Internal Server Error
        data:
          type: object
          additionalProperties:
            type: string
          default: {}
          x-apidog-orders: []
          properties: {}
          x-apidog-ignore-properties: []
      x-apidog-orders:
        - success
        - message
        - data
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes:
    cookieAuth:
      type: apikey
      in: cookie
      name: sessionid
    oauth2:
      type: oauth2
      flows: {}
    APIKeyHeader:
      type: apikey
      in: header
      name: X-API-Key
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: /api/login/access-token
    ejentoAuthKey:
      type: apikey
      in: header
      name: ejento-auth-key
      description: Server-to-server authentication key (EJENTO_SECRET / EJENTO_AUTH_KEY)
    Ocp-Apim-Subscription-Key:
      type: apikey
      in: header
      name: Ocp-Apim-Subscription-Key
      description: Subscription key. Required on every endpoint.
    Authorization:
      type: bearer
      scheme: bearer
      description: >-
        Your access token, sent as `Authorization: Bearer <token>` alongside the
        subscription key.
    Combination:
      group:
        - id: 619278
        - id: 619279
      type: combination
servers:
  - url: https://{{your-server-name}}
    description: Prod Env
security: []

```