---
title: "Retrieve Information About an Existing Evaluation Run"
method: GET
path: "/v2/gen-ai/evaluation_runs/{evaluation_run_uuid}"
tags: ["DigitalOcean-public.v2-new_GradientAI Platform"]
---

# Retrieve Information About an Existing Evaluation Run

`GET /v2/gen-ai/evaluation_runs/{evaluation_run_uuid}`

To retrive information about an existing evaluation run, send a GET request to `/v2/gen-ai/evaluation_runs/{evaluation_run_uuid}`.

## Path parameters

- `evaluation_run_uuid` string, required

## Response `200`

A successful response.

- ApiGetEvaluationRunOutput
  - `evaluation_run` ApiEvaluationRun
    - `agent_deleted` boolean — Whether agent is deleted
    - `agent_name` string — Agent name
    - `agent_uuid` string — Agent UUID.
    - `agent_version_hash` string — Version hash
    - `agent_workspace_uuid` string — Agent workspace uuid
    - `created_by_user_email` string
    - `created_by_user_id` string, uint64
    - `error_description` string — The error description
    - `evaluation_run_uuid` string — Evaluation run UUID.
    - `evaluation_test_case_workspace_uuid` string — Evaluation test case workspace uuid
    - `finished_at` string, date-time — Run end time.
    - `pass_status` boolean — The pass status of the evaluation run based on the star metric.
    - `queued_at` string, date-time — Run queued time.
    - `run_level_metric_results` ApiEvaluationMetricResult[]
      - `error_description` string — Error description if the metric could not be calculated.
      - `metric_name` string — Metric name
      - `metric_value_type` 'METRIC_VALUE_TYPE_UNSPECIFIED' | 'METRIC_VALUE_TYPE_NUMBER' | 'METRIC_VALUE_TYPE_STRING' | 'METRIC_VALUE_TYPE_PERCENTAGE'
      - `number_value` number, double — The value of the metric as a number.
      - `reasoning` string — Reasoning of the metric result.
      - `string_value` string — The value of the metric as a string.
    - `run_name` string — Run name.
    - `star_metric_result` ApiEvaluationMetricResult
      - `error_description` string — Error description if the metric could not be calculated.
      - `metric_name` string — Metric name
      - `metric_value_type` 'METRIC_VALUE_TYPE_UNSPECIFIED' | 'METRIC_VALUE_TYPE_NUMBER' | 'METRIC_VALUE_TYPE_STRING' | 'METRIC_VALUE_TYPE_PERCENTAGE'
      - `number_value` number, double — The value of the metric as a number.
      - `reasoning` string — Reasoning of the metric result.
      - `string_value` string — The value of the metric as a string.
    - `started_at` string, date-time — Run start time.
    - `status` 'EVALUATION_RUN_STATUS_UNSPECIFIED' | 'EVALUATION_RUN_QUEUED' | 'EVALUATION_RUN_RUNNING_DATASET' | 'EVALUATION_RUN_EVALUATING_RESULTS' | 'EVALUATION_RUN_CANCELLING' | 'EVALUATION_RUN_CANCELLED' | 'EVALUATION_RUN_SUCCESSFUL' | 'EVALUATION_RUN_PARTIALLY_SUCCESSFUL' | 'EVALUATION_RUN_FAILED' — Evaluation Run Statuses
    - `test_case_description` string — Test case description.
    - `test_case_name` string — Test case name.
    - `test_case_uuid` string — Test-case UUID.
    - `test_case_version` integer — Test-case-version.

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `404` — The resource was not found.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

---

[API](https://skmtc.net/digitalocean/apis/digitalocean-api.md) · [All operations](https://skmtc.net/digitalocean/apis/digitalocean-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalocean/digitalocean-api/revisions/cb3bf9b21459/schema)