---
title: "List the runs of a regression test"
method: GET
path: "/regression-tests/{regressionTestId}/history"
tags: ["RegressionTests", "Beta"]
---

# List the runs of a regression test

`GET /regression-tests/{regressionTestId}/history`

## Request

- Base URL: `https://public.escape.tech/v3`
- URL: `https://public.escape.tech/v3/regression-tests/{regressionTestId}/history`
- Auth: API key in header `X-ESCAPE-API-KEY`

List the runs of a regression test, most recent first. When the test does not exist (or belongs to another organization), the internal API returns an error that is forwarded as a 404 to avoid leaking its existence.

## Path parameters

- `regressionTestId` string, uuid, required: The regression test ID

## Query parameters

- `cursor` string: The cursor to start the pagination from. Returned by the previous page response. If not provided, the first page will be returned.
- `size` integer: The number of items to return per page

## Response `200`

OK

- object
  - `nextCursor` string, nullable, required
  - `totalCount` integer
  - `data` object[], required
    - `id` string, uuid, required: The id of the regression test run
    - `status` 'CANCELLED' | 'CLARIFICATION_GIVEN' | 'CLARIFICATION_REQUIRED' | 'ERROR' | 'NOT_STARTED' | 'RUNNING' | 'TEST_FAILED' | 'TEST_PASSED', required: The status of the run
    - `clarificationQuestion` string, nullable, required: The question the agent asked, when the run needs a clarification
    - `clarificationAnswer` string, nullable, required: The answer given to the clarification question
    - `validationId` string, nullable, required: The id of the validation (scan) that ran the test
    - `createdAt` string, required: When the run was created
    - `updatedAt` string, required: When the run was last updated

## Other responses

- `400`: Pagination error
- `404`: Not found

---

[API](https://skmtc.dev/escape/apis/escape-public-api.md) - [All operations](https://skmtc.dev/escape/apis/escape-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/escape/apis/escape-public-api/revisions/2eab35df40c7?raw)