---
title: "Get Evaluation"
method: GET
path: "/api/v1/evaluations/{evaluation_id}"
tags: ["evals"]
---

# Get Evaluation

`GET /api/v1/evaluations/{evaluation_id}`

Get detailed information about a specific evaluation.

## Path parameters

- `evaluation_id` string, required

## Response `200`

Successful Response

- GetEvaluationResponse — Response for getting evaluation details
  - `evaluation_id` string, required
  - `name` string, required
  - `status` 'PENDING' | 'RUNNING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'TIMEOUT' | 'CANCELLED', required — Evaluation status enum
  - `eval_type` 'suite' | 'training' | 'environment', required — Evaluation type enum
  - `user_id` string, nullable — User ID of evaluation owner
  - `team_id` string, nullable — Team ID if evaluation is owned by a team
  - `environment_ids` string[], nullable
  - `environment_names` string[], nullable
  - `suite_id` string, nullable
  - `run_id` string, nullable
  - `version_id` string, nullable
  - `is_hosted` boolean
  - `sandbox_id` string, nullable
  - `inference_model` string, nullable
  - `eval_config` object, nullable
  - `error_message` string, nullable
  - `logs` string, nullable
  - `model_name` string, nullable
  - `dataset` string, nullable
  - `framework` string, nullable
  - `task_type` string, nullable
  - `description` string, nullable
  - `tags` string[]
  - `total_samples` integer, required
  - `avg_score` number, nullable
  - `min_score` number, nullable
  - `max_score` number, nullable
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `metadata` object, nullable
  - `metrics` object, nullable
  - `viewer_url` string, nullable
  - `is_public` boolean — Whether this evaluation is publicly shareable by link
  - `show_on_leaderboard` boolean — Whether this public evaluation appears on environment leaderboards
  - `statistics` object, nullable — Statistics format (totalResults, totalReward, avgReward)
  - `chartData` object, nullable — Histogram and statistics for visualization
  - `rubricInfo` object, nullable — Rubric with detected metrics and weights
  - `detailedMetrics` object, nullable — Detailed statistics for each detected metric
  - `rewardStats` object, nullable — Reward statistics for backward compatibility

## Other responses

- `401` — Authorization failed
- `422` — Invalid request data

---

[API](https://skmtc.net/primeintellect/apis/pi-api.md) · [All operations](https://skmtc.net/primeintellect/apis/pi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/primeintellect/pi-api/versions/60efc9b3ff2a/schema)