---
title: "Retrieve evaluation"
method: GET
path: "/agents/{agent_id}/evaluations/{evaluation_id}"
tags: ["Evaluations"]
---

# Retrieve evaluation

`GET /agents/{agent_id}/evaluations/{evaluation_id}`

Retrieve a single evaluation result by ID. The evaluation must belong to the specified agent.

## Path parameters

- `agent_id` string, required
- `evaluation_id` string, required

## Response `200`

The requested evaluation result.

- object
  - `evaluation` EvaluationResult
    - `evaluation_id` string — Unique ID of this evaluation.
    - `interaction_id` string — ID of the interaction that was evaluated.
    - `agent_id` string — ID of the agent.
    - `created_ts` string, date-time — When the evaluation was created.
    - `status` 'completed' | 'failed' — Terminal status of the evaluation.
    - `grade` 'pass' | 'needs_review' | 'needs_attention' — Overall grade computed from criteria, sentiment, and call outcome.
    - `call_successful` 'success' | 'failure' | 'unknown' — Whether the agent's call/task was successful.
    - `sentiment` 'positive' | 'neutral' | 'negative', nullable — Detected sentiment of the interaction (null if sentiment analysis is disabled).
    - `summary` string, nullable — One or two sentence narrative of what happened in the interaction.
    - `criteria_results` object[] — Per-criterion pass/fail results with rationales.
      - `id` string
      - `name` string
      - `type` 'prohibited_action' | 'prohibited_words' | 'voice_tone' | 'other'
      - `priority` 'needs_review' | 'needs_attention'
      - `result` 'success' | 'failure' | 'unknown'
      - `rationale` string
    - `data_results` object[] — Extracted data point values from the conversation.
      - `id` string
      - `name` string
      - `data_type` 'string' | 'boolean' | 'integer' | 'number'
      - `value` unknown
    - `applied_tags` string[] — Tags applied to this evaluation.

## Other responses

- `401` — Unauthorized — missing or invalid credentials.
- `404` — Evaluation not found or does not belong to this agent.

---

[API](https://skmtc.dev/gumloop/apis/public-api.md) · [All operations](https://skmtc.dev/gumloop/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gumloop/public-api/revisions/115f2d6ce387/schema)