---
title: "Get Eval Run Responses"
method: GET
path: "/v2/eval-runs/{eval_run_uuid}/responses"
tags: ["Eval Runs"]
---

# Get Eval Run Responses

`GET /v2/eval-runs/{eval_run_uuid}/responses`

Retrieve all responses for a specific eval run.

Args:
    eval_run_uuid (str): UUID of the eval run to retrieve responses for.
    workspace_uuid (str, optional): UUID of the workspace. Defaults to None.

Returns:
    list[EvalScoredResponse]: List of scored responses for the eval run.

Raises:
    AymaraAPIError: If the organization is missing or the eval run is not found.

Example:
    GET /api/eval-runs/{eval_run_uuid}/responses

## Path parameters

- `eval_run_uuid` string, required

## Query parameters

- `workspace_uuid` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- PagedEvalScoredResponse
  - `items` EvalScoredResponse[], required
    - `prompt_uuid` string, required — Unique identifier for the prompt.
    - `thread_uuid` string, nullable — Unique identifier for the thread, if any.
    - `turn_number` integer — Turn number in the conversation (default: 1).
    - `continue_thread` boolean — Whether to continue the thread after this response.
    - `content` union — Content of the AI response or a file reference.
      - string
      - FileReference — Reference to a file, either by file_uuid (preferred) or legacy remote_file_path. When file_uuid is provided, the system will look up the File record and use its remote_file_path. The remote_file_path field is maintained for backwards compatibility.
        - `file_uuid` string, nullable
        - `remote_file_path` string, nullable
    - `content_type` 'text' | 'image' | 'video' — Content type for AI interactions.
    - `exclude_from_scoring` boolean — Whether to exclude this response from scoring.
    - `ai_refused` boolean — Whether the AI refused to answer the prompt.
    - `response_uuid` string, nullable — Unique identifier for the response, if any.
    - `explanation` string, nullable — Explanation for the response, if any.
    - `confidence` number, nullable — Confidence score for the response, if any.
    - `is_passed` boolean, nullable — Whether the response passed the evaluation, if any.
    - `next_prompt` EvalPrompt
      - `prompt_uuid` string, required — Unique identifier for the prompt.
      - `thread_uuid` string, nullable — Unique identifier for the thread, if any.
      - `turn_number` integer — Turn number in the conversation (default: 1).
      - `content` string, required — Content of the prompt.
      - `category` string, nullable — Category of the prompt, if any.
    - `manually_updated` boolean — Whether this response was manually updated.
    - `manually_updated_by` UserOutSchema
      - `email` string, required
      - `organization` OrganizationOutSchema
        - `org_uuid` string, required
        - `name` string, required
      - `workspace` WorkspaceOutSchema
        - `workspace_uuid` string, nullable
        - `name` string, nullable
        - `organization_name` string, nullable
        - `organization_uuid` string, nullable
      - `org_admin_emails` string[], nullable
      - `is_admin` boolean, required
      - `is_impersonating` boolean, required
      - `feature_flags` FeatureFlags, required
        - `enable_dashboard` boolean, required
    - `manually_updated_at` string, date-time, nullable — Timestamp when this response was last manually updated.
    - `update_history` AnswerHistoryOut[], nullable — History of manual updates, if requested.
      - `answer_history_uuid` string, required — Unique identifier for the history entry.
      - `updated_by` UserOutSchema
        - `email` string, required
        - `organization` OrganizationOutSchema
          - `org_uuid` string, required
          - `name` string, required
        - `workspace` WorkspaceOutSchema
          - `workspace_uuid` string, nullable
          - `name` string, nullable
          - `organization_name` string, nullable
          - `organization_uuid` string, nullable
        - `org_admin_emails` string[], nullable
        - `is_admin` boolean, required
        - `is_impersonating` boolean, required
        - `feature_flags` FeatureFlags, required
          - `enable_dashboard` boolean, required
      - `previous_is_passed` boolean, nullable — Previous is_passed value.
      - `previous_confidence` number, nullable — Previous confidence value.
      - `previous_explanation` string, nullable — Previous explanation value.
      - `new_is_passed` boolean, nullable — New is_passed value.
      - `new_confidence` number, nullable — New confidence value.
      - `new_explanation` string, nullable — New explanation value.
      - `updated_at` string, date-time, required — Timestamp when the update was made.
  - `count` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/aymara-ai/apis/aymara-api.md) · [All operations](https://skmtc.net/aymara-ai/apis/aymara-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aymara-ai/aymara-api/versions/0cb64ef11adf/schema)