---
title: "Get Eval Prompts"
method: GET
path: "/v2/evals/{eval_uuid}/prompts"
tags: ["Evals"]
---

# Get Eval Prompts

`GET /v2/evals/{eval_uuid}/prompts`

## Request

- Base URL: `https://api.aymara.ai`
- URL: `https://api.aymara.ai/v2/evals/{eval_uuid}/prompts`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/aymara-ai/apis/aymara-api/docs/v2/evals/:eval_uuid/prompts/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve prompts for a specific eval if they exist.

Args:
    eval_uuid (str): UUID of the eval to get prompts for.
    workspace_uuid (str, optional): Optional workspace UUID for filtering.

Returns:
    list[EvalPrompt]: List of prompts and metadata for the eval.

Raises:
    AymaraAPIError: If the eval is not found.

Example:
    GET /api/evals/{eval_uuid}/prompts

## Path parameters

- `eval_uuid` string, required

## Query parameters

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

## Response `200`

OK

- PagedEvalPrompt
  - `items` EvalPrompt[], 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).
    - `content` string, required: Content of the prompt.
    - `category` string, nullable: Category of the prompt, if any.
  - `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

## Changes

- **2026-02-08** `9b529d67a7d0`: 9 warning
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `400`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `401`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `403`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `404`
  - …5 more

[Operation history](https://skmtc.dev/aymara-ai/apis/aymara-api/changes/v2/evals/:eval_uuid/prompts/get.md)

---

[API](https://skmtc.dev/aymara-ai/apis/aymara-api.md) - [All operations](https://skmtc.dev/aymara-ai/apis/aymara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aymara-ai/apis/aymara-api/revisions/0cb64ef11adf?raw)