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

# Get Evaluation

`GET /v1/evaluations/{evaluation_id}`

Get evaluation status.

Args:
    evaluation_id: UUID of the evaluation (can be job_id or evaluation_id)
    claims: JWT claims with user and team info
    diamond_domain: Diamond domain orchestrator

Returns:
    Current evaluation status with timestamps (returns Diamond's evaluation_id as source of truth)

Raises:
    HTTPException: 404 if evaluation not found or user lacks access
    HTTPException: 503 if evaluation status cannot be retrieved

## Path parameters

- `evaluation_id` string, uuid, required

## Response `200`

Successful Response

- EvaluationStatusResponse — Response model for evaluation status.
  - `evaluation_id` string, uuid, required
  - `status` string, required
  - `scores` object, nullable
  - `created_at` integer, required
  - `started_at` integer, nullable, required
  - `completed_at` integer, nullable, required
  - `error_message` string, nullable, required
  - `status_message` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vijilai/apis/vijil-console-api-combined.md) · [All operations](https://skmtc.net/vijilai/apis/vijil-console-api-combined/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vijilai/vijil-console-api-combined/versions/a8b2ee2b2d06/schema)