---
title: "Get an evaluation run"
method: GET
path: "/openai/evals/{eval_id}/runs/{run_id}"
tags: ["Evals"]
---

# Get an evaluation run

`GET /openai/evals/{eval_id}/runs/{run_id}`

Get an evaluation run by ID.

## Path parameters

- `eval_id` string, required
- `run_id` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- EvalRun — A schema representing an evaluation run.
  - `object` 'eval.run', required — The type of the object. Always "eval.run".
  - `id` string, required — Unique identifier for the evaluation run.
  - `eval_id` string, required — The identifier of the associated evaluation.
  - `status` string, required — The status of the evaluation run.
  - `model` string, required — The model that is evaluated, if applicable.
  - `name` string, required — The name of the evaluation run.
  - `created_at` integer, required — Unix timestamp (in seconds) when the evaluation run was created.
  - `report_url` string, required — The URL to the rendered evaluation run report on the UI dashboard.
  - `result_counts` OpenAIEvalRunResultCounts, required
    - `total` integer, required
    - `errored` integer, required
    - `failed` integer, required
    - `passed` integer, required
  - `per_model_usage` OpenAIEvalRunPerModelUsage[], required — Usage statistics for each model during the evaluation run.
    - `model_name` string, required
    - `invocation_count` integer, required
    - `prompt_tokens` integer, required
    - `completion_tokens` integer, required
    - `total_tokens` integer, required
    - `cached_tokens` integer, required
  - `per_testing_criteria_results` OpenAIEvalRunPerTestingCriteriaResults[], required — Results per testing criteria applied during the evaluation run.
    - `testing_criteria` string, required
    - `passed` integer, required
    - `failed` integer, required
  - `data_source` unknown, required
  - `metadata` OpenAIMetadata, required — Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.
  - `error` OpenAIEvalApiError, required — An object representing an error response from the Eval API.
    - `code` string, required — The error code.
    - `message` string, required — The error message.
  - `modified_at` integer
  - `created_by` string — the name of the person who created the run.
  - `properties` object — Set of immutable 16 key-value pairs that can be attached to an object for storing additional information. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.

## Other responses

- `default` — An unexpected error response.

---

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