---
title: "Get a list of runs for an evaluation"
method: GET
path: "/openai/evals/{eval_id}/runs"
tags: ["Evals"]
---

# Get a list of runs for an evaluation

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

Get a list of runs for an evaluation.

## Path parameters

- `eval_id` string, required

## Query parameters

- `api-version` string, required
- `after` string
- `limit` integer
- `order` 'asc' | 'desc'
- `status` 'queued' | 'in_progress' | 'completed' | 'canceled' | 'failed'

## Response `200`

The request has succeeded.

- object — The response data for a requested list of items.
  - `data` EvalRun[], required — The requested list of items.
    - `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.
  - `first_id` string — The first ID represented in this list.
  - `last_id` string — The last ID represented in this list.
  - `has_more` boolean, required — A value indicating whether there are additional values available not captured in this list.

## 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/versions/b52c14a89ea1/schema)