---
title: "List issues in rescan scope"
method: POST
path: "/api/v2/rescanAgent/listIssues"
tags: ["Rescan Agent"]
---

# List issues in rescan scope

`POST /api/v2/rescanAgent/listIssues`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v2/rescanAgent/listIssues`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

List vulnerability issues that are in scope for the current rescan agent session. Optionally filter by file path to narrow results to a specific file. Returns issue summaries including title, affected file, line range, and current status. Use this to discover which existing issues the agent should verify during a rescan.

## Request body

- RescanAgentListIssuesRequest: Input for listing issues in scope for the rescan agent. Optionally filter by file path.
  - `file` string: Optional file path to filter issues by. Only issues affecting this file are returned. Omit to list all issues in scope.

## Response `200`

Issues retrieved successfully

- RescanAgentListIssuesResponse: Response containing the list of issues in scope.
  - `issues` object[], required: Issues matching the filter criteria within the rescan scope.
    - `id` string: Unique issue identifier (UUID).
    - `generatedTitle` string: Short human-readable title summarizing the vulnerability.
    - `vulnClass` string: Vulnerability class (e.g. "XSS", "SQLi").
    - `vulnCategory` string: Broader vulnerability category.
    - `affectedFile` string: Repository-relative path of the affected file.
    - `startLine` integer: Start line of the vulnerable code.
    - `endLine` integer: End line of the vulnerable code.
    - `issueStatus` string: Current lifecycle status of the issue (e.g. "open", "resolved").

## Other responses

- `401`: Error Response

---

[API](https://skmtc.dev/zeropath/apis/zeropath-api.md) - [All operations](https://skmtc.dev/zeropath/apis/zeropath-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zeropath/apis/zeropath-api/revisions/126e9c80ba0d?raw)