---
title: "List Prompt Test Cases"
method: GET
path: "/api/v2/projects/{project_id}/prompt-datasets/{dataset_id}/test-cases"
tags: ["Prompt Datasets"]
---

# List Prompt Test Cases

`GET /api/v2/projects/{project_id}/prompt-datasets/{dataset_id}/test-cases`

Retrieve all row-level test cases in a prompt dataset. Use to review dataset contents or export for analysis.

`page_size` defaults to 30, maximum 100.

## Path parameters

- `project_id` string, required
- `dataset_id` string, required

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

PromptTestCasesListResponse(data: list[server.api_routes.prompt_datasets_api_v2.PromptTestCaseResponse], pagination: server.api_routes.api_v2_common.PaginationInfo)

- object
  - `data` PromptTestCaseResponse[], required
    - `id` string, uuid, required
    - `inputs` object, required
    - `output` string, nullable
    - `output_message` union
      - union
        - UserMessageInfo
          - `content` union[], required
            - union
              - …
          - `role` 'user'
        - SystemMessageInfo
          - `content` string, required
          - `role` 'system'
        - DeveloperMessageInfo
          - `content` string, required
          - `role` 'developer'
        - AssistantMessageInfo
          - `content` union[], required
            - union
              - …
          - `role` 'assistant'
      - UserMessage
        - `content` union, required
          - string
          - union[]
            - union
              - …
        - `role` 'user'
      - AssistantMessage
        - `content` union, required
          - string
          - union[]
            - union
              - …
        - `role` 'assistant'
      - SystemMessage
        - `content` string, required
        - `role` 'system'
      - DeveloperMessage
        - `content` string, required
        - `role` 'developer'
    - `metadata` object, nullable
    - `media_inputs` object, nullable
    - `history` union[], nullable
      - union
        - union
          - UserMessageInfo
            - `content` union[], required
              - …
            - `role` 'user'
          - SystemMessageInfo
            - `content` string, required
            - `role` 'system'
          - DeveloperMessageInfo
            - `content` string, required
            - `role` 'developer'
          - AssistantMessageInfo
            - `content` union[], required
              - …
            - `role` 'assistant'
        - UserMessage
          - `content` union, required
            - string
            - union[]
              - …
          - `role` 'user'
        - AssistantMessage
          - `content` union, required
            - string
            - union[]
              - …
          - `role` 'assistant'
        - SystemMessage
          - `content` string, required
          - `role` 'system'
        - DeveloperMessage
          - `content` string, required
          - `role` 'developer'
  - `pagination` PaginationInfo, required
    - `page` integer, required
    - `page_size` integer, required
    - `has_next` boolean, required

---

[API](https://skmtc.net/freeplay/apis/freeplay-api.md) · [All operations](https://skmtc.net/freeplay/apis/freeplay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/freeplay/freeplay-api/revisions/69c553220183/schema)