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

# Get evaluation histogram data

> Get histogram data for the specified evaluation name



## OpenAPI

````yaml /api-specs/cloud/public-api.json get /api/model-services/v1/aisystem/{system_id}/version/{version_id}/chart/histogram/eval_name/{eval_name}
openapi: 3.0.3
info:
  title: Domino Public API
  description: Reference for Domino's public REST API endpoints.
  version: 6.4.0
  x-catalog-key: nucleus
servers:
  - url: https://mycluster.domino.tech
    description: >-
      Replace 'mycluster.domino.tech' with your Domino cluster hostname. For
      Domino Cloud customers, that is `your-subdomain`.domino.tech (e.g.,
      acme.domino.tech). For self-hosted deployments, it is the hostname you
      reach the Domino UI at.
security: []
tags:
  - name: Projects
  - name: Project templates
  - name: Workspaces
  - name: Jobs
  - name: HPC Jobs
  - name: Environments
  - name: Hardware Tiers
  - name: Datasets
  - name: Data Sources
  - name: GenAI
  - name: AI Systems
  - name: Apps
  - name: App versions
  - name: App instances
  - name: Model APIs
  - name: Registered models
  - name: Model deployment
  - name: Extensions
  - name: Cost and billing
  - name: Users and organizations
  - name: Service accounts
  - name: Personal Access Tokens
  - name: Personal Access Tokens (admin)
  - name: Audit Trail
  - name: Custom metrics
  - name: PPM
  - name: Model Monitoring models
  - name: Model Monitoring drift and quality
  - name: Model Monitoring settings
  - name: Model Monitoring authentication
  - name: Governance bundles
  - name: Governance policies
  - name: Governance evidence and results
  - name: Governance operations
  - name: NetApp Volumes
  - name: NetApp Volumes snapshots
  - name: NetApp Volumes filesystems
  - name: NetApp Volumes transfers
  - name: Tags
  - name: Properties
externalDocs:
  description: OpenAPI
  url: https://swagger.io/resources/open-api/
paths:
  /api/model-services/v1/aisystem/{system_id}/version/{version_id}/chart/histogram/eval_name/{eval_name}:
    get:
      tags:
        - AI Systems
      summary: Get evaluation histogram data
      description: Get histogram data for the specified evaluation name
      operationId: get_evaluation_histogram
      parameters:
        - in: path
          name: system_id
          required: true
          schema:
            type: string
        - in: path
          name: version_id
          required: true
          schema:
            type: string
        - in: path
          name: eval_name
          required: true
          schema:
            type: string
        - description: >-
            Start time for the query in RFC3339 format. Defaults to 7 days ago
            if not specified.
          explode: false
          in: query
          name: start_time
          schema:
            description: >-
              Start time for the query in RFC3339 format. Defaults to 7 days ago
              if not specified.
            format: date-time
            type: string
        - description: >-
            Optional numeric metric to aggregate per categorical value. When
            omitted, bars represent trace counts.
          explode: false
          in: query
          name: metric
          schema:
            description: >-
              Optional numeric metric to aggregate per categorical value. When
              omitted, bars represent trace counts.
            type: string
        - description: >-
            Aggregation applied to 'metric' per categorical value. Defaults to
            'count'.
          explode: false
          in: query
          name: aggregation
          schema:
            description: >-
              Aggregation applied to 'metric' per categorical value. Defaults to
              'count'.
            enum:
              - count
              - mean
              - min
              - max
              - p50
              - p95
            type: string
        - description: >-
            Optional URL-encoded JSON filter. See the /filters endpoint for
            available fields.
          explode: false
          in: query
          name: filter
          schema:
            description: >-
              Optional URL-encoded JSON filter. See the /filters endpoint for
              available fields.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/mlflow-proxy_GetEvaluationHistogramResponseBody
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/mlflow-proxy_ErrorModel'
          description: Error
components:
  schemas:
    mlflow-proxy_GetEvaluationHistogramResponseBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          example: >-
            /api/model-services/v1/aisystem/schemas/GetEvaluationHistogramResponseBody.json
          format: uri
          readOnly: true
          type: string
        aggregation:
          description: >-
            Echoes the aggregation applied ("count" when no metric was
            requested).
          enum:
            - count
            - mean
            - min
            - max
            - p50
            - p95
          type: string
        available_metrics:
          description: Numeric metrics that can be aggregated for this categorical.
          items:
            type: string
          nullable: true
          type: array
        data:
          description: Histogram buckets, one per categorical value.
          items:
            $ref: '#/components/schemas/mlflow-proxy_Point'
          nullable: true
          type: array
        end_time:
          description: Exclusive end of the histogram window.
          format: date-time
          type: string
        metric:
          description: Echoes the aggregated metric; empty in count mode.
          type: string
        start_time:
          description: Inclusive beginning of the histogram window.
          format: date-time
          type: string
        unit:
          description: >-
            Unit of the aggregated values, when known (e.g. "ms" for response
            time).
          type: string
        x_axis_label:
          description: Name of the evaluation represented on the x-axis.
          type: string
      required:
        - x_axis_label
        - start_time
        - end_time
        - data
        - aggregation
        - available_metrics
      type: object
    mlflow-proxy_ErrorModel:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          example: /api/model-services/v1/aisystem/schemas/ErrorModel.json
          format: uri
          readOnly: true
          type: string
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          example: Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/mlflow-proxy_ErrorDetail'
          nullable: true
          type: array
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          example: https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          example: 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          example: Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          example: https://example.com/errors/example
          format: uri
          type: string
      type: object
    mlflow-proxy_Point:
      additionalProperties: false
      properties:
        count:
          description: >-
            Number of traces backing this categorical value. In count mode it
            equals 'value'; in metric-aggregation mode it lets the frontend
            build weighted "Other" rollups.
          format: int64
          type: integer
        label:
          description: Categorical value this bar represents.
          type: string
        value:
          description: >-
            Bar value: the trace count (count mode) or the aggregated metric
            value.
          format: double
          type: number
      required:
        - value
        - label
        - count
      type: object
    mlflow-proxy_ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object

````

## Related topics

- [Get labels for metric and label evaluations](/api-reference/ai-systems/get-labels-for-metric-and-label-evaluations.md)
- [Get metrics timeseries](/api-reference/ai-systems/get-metrics-timeseries.md)
- [Clinical Data Explorer](/cloud/platform-capabilities/features/extensions/data-visualization.md)
- [Getting started with Domino: Build a transaction review App](/cloud/platform-overview/getting-started-with-domino/index.md)
