---
title: "List Testsets in Project"
method: GET
path: "/projects/{projectId}/testsets"
---

# List Testsets in Project

`GET /projects/{projectId}/testsets`

Retrieve a paginated list of Testsets belonging to a Project.

## Path parameters

- `projectId` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Successfully retrieved list of Testsets.

- object
  - `data` Testset[], required
    - `id` string, required — The ID of the Testset.
    - `name` string, required — The name of the Testset.
    - `description` string, required — The description of the Testset.
    - `jsonSchema` object, required — The JSON schema for each Testcase in the Testset.
    - `fieldMapping` object, required — Maps top-level keys of the Testcase schema to their roles (input/expected output). Unmapped fields are treated as metadata.
      - `inputs` string[], required — Fields that represent inputs to the AI system.
      - `expected` string[], required — Fields that represent expected outputs.
      - `metadata` string[], required — Fields that are not inputs or expected outputs.
  - `nextCursor` string, nullable, required
  - `hasMore` boolean, required
  - `total` integer

## Other responses

- `401` — Error indicating that the request is not authenticated.
- `500` — An internal service error indicating an issue with the Scorecard service.

## Changes

- **2025-05-28** `97ddfea9a000` — 1 breaking, 1 info
  - removed the required property `data/items/fieldMapping/labels` from the response with the `200` status
  - added the required property `data/items/fieldMapping/expected` to the response with the `200` status

[Change history](https://skmtc.dev/scorecard-ai/apis/scorecard-api/changes/projects/:projectId/testsets/get.md)

---

[API](https://skmtc.dev/scorecard-ai/apis/scorecard-api.md) · [All operations](https://skmtc.dev/scorecard-ai/apis/scorecard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scorecard-ai/scorecard-api/revisions/121aaa257802/schema)