---
title: "List Runs"
method: GET
path: "/projects/{projectId}/runs"
---

# List Runs

`GET /projects/{projectId}/runs`

Retrieve a paginated list of all Runs for a Project. Runs are ordered by creation date, most recent first.

## Path parameters

- `projectId` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Successfully retrieved list of runs.

- object
  - `data` Run[], required
    - `id` string, required — The ID of the Run.
    - `testsetId` string, nullable, required — The ID of the Testset this Run is testing.
    - `systemId` string, uuid, nullable, required — The ID of the system this Run is using.
    - `systemVersionId` string, uuid, nullable, required — The ID of the system version this Run is using.
    - `metricIds` string[], required — The IDs of the metrics this Run is using.
    - `metricVersionIds` string[], required — The IDs of the metric versions this Run is using.
    - `numRecords` number, required — The number of records in the Run.
    - `numExpectedRecords` number, nullable, required — The number of expected records in the Run. Determined by the number of testcases in the Run's Testset at the time of Run creation.
    - `numScores` number, required — The number of completed scores in the Run so far.
    - `status` 'pending' | 'awaiting_execution' | 'running_execution' | 'awaiting_scoring' | 'running_scoring' | 'awaiting_human_scoring' | 'completed', required — The status of the Run.
  - `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-09-30** `47c2214e7180` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/scorecard-ai/apis/scorecard-api/changes/projects/:projectId/runs/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)