---
title: "Get Run"
method: GET
path: "/runs/{runId}"
---

# Get Run

`GET /runs/{runId}`

Retrieve a specific Run by ID.

## Path parameters

- `runId` string, required

## Response `200`

Successfully retrieved Run.

- Run — A Run in the Scorecard system.
  - `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.

## 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/runs/:runId/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)