---
title: "List retests"
method: GET
path: "/retests"
tags: ["Retests", "Beta"]
---

# List retests

`GET /retests`

## Request

- Base URL: `https://public.escape.tech/v3`
- URL: `https://public.escape.tech/v3/retests`
- Auth: API key in header `X-ESCAPE-API-KEY`

List issue retests of the organization. The id of each item is the scan 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
- `sortType` 'SEVERITY' | 'createdAt': The type to sort by
- `sortDirection` 'asc' | 'desc': The direction to sort by
- `profileIds` union: Filter by profile IDs
  - string
  - string[]

## Response `200`

OK

- object
  - `nextCursor` string, nullable, required
  - `totalCount` integer
  - `data` object[], required
    - `id` string, uuid, required: The scan ID of the retest
    - `profileId` string, required: The profile the retest ran on
    - `status` string, required: The scan status of the retest
    - `progressRatio` number, required: The progress ratio of the retest scan
    - `createdAt` string, required: The date and time the retest was created
    - `finishedAt` string, nullable, required: The date and time the retest finished
    - `context` string, nullable, required: Optional operator context passed when starting the retest
    - `agents` object[], required: Retest agents with status and outcome
      - `id` string, uuid, nullable, required: The agent id. Null until the agent has started.
      - `issueId` string, uuid, required: The issue this agent retests
      - `status` 'FAILED' | 'FINISHED' | 'RUNNING' | 'null', nullable, required: The agent run status. Null until the agent has started.
      - `outcome` 'FAILED' | 'NOT_TESTED' | 'VERIFIED_FIXED' | 'VULNERABLE' | 'null', nullable, required: The retest outcome. Null while the report is still pending.

## Other responses

- `400`: Pagination error

---

[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)