---
title: "List snapshotted issues for an audit"
method: GET
path: "/audits/{auditId}/issues/items"
tags: ["Audits"]
---

# List snapshotted issues for an audit

`GET /audits/{auditId}/issues/items`

Retrieves a list of all issues that have been shared with an audit.

The issues returned are immutable, point-in-time snapshots; there may be duplicates of issues that have been snapshotted at different times.
The GET /audits/{auditId}/issues/snapshots endpoint can be used to retrieve metadata about the snapshots that issues belong to.
Issues represent compliance findings from a variety of sources that need to be tracked and remediated.

Supports filtering by:
- `search`: full text search across issue title and description
- `snapshotId`: filtering to a specific snapshot or snapshots, which represent point-in-time captures of issues. Use the GET /audits/{auditId}/issues/snapshots endpoint to retrieve snapshot IDs and metadata.
- `createdAfterDate` / `createdBeforeDate`: filter to issues created within a date range (inclusive)
- `detectedAfterDate` / `detectedBeforeDate`: filter to issues detected within a date range (inclusive)

Results are sorted by issue creation date in descending order (newest first) by default.
Use `orderBy` and `orderDirection` to customize sorting.
Sort parameters must remain consistent across paginated requests.

Uses cursor-based pagination. To paginate:
1. Make initial request with desired `pageSize`
2. Check `results.pageInfo.hasNextPage`
3. Use `results.pageInfo.endCursor` as `pageCursor` for next request

Rate limit: 10 requests / minute.

## Path parameters

- `auditId` string, required

## Query parameters

- `pageSize` integer — Controls the maximum number of items returned in one response from the API.
- `pageCursor` string — A marker or pointer, telling the API where to start fetching items for the subsequent page in a paginated dataset. Note that the requested page will not include the item that corresponds to this cursor but will start from the one immediately after this cursor.
- `search` string
- `snapshotIdMatchesAny` string[]
- `createdAfterDate` string, date-time
- `createdBeforeDate` string, date-time
- `detectedAfterDate` string, date-time
- `detectedBeforeDate` string, date-time
- `orderBy` 'createdAt' | 'lastModifiedAt' | 'detectedAt' — Allowed values for the `orderBy` query parameter on issue snapshot item endpoints.
- `orderDirection` 'asc' | 'desc' — `"asc"` for ascending, `"desc"` for descending.

## Response `200`

Ok

- PaginatedIssueSnapshotItemsResponse
  - `results` object, required
    - `data` IssueSnapshotItem[], required
      - `id` string, required — The unique identifier for the snapshot of an issue. This is distinct from the issueId, which identifies the underlying issue across snapshots. The snapshot item ID is unique to this specific snapshot of the issue.
      - `title` string — The issue title
      - `description` string — The issue description
      - `readableIssueId` string, required — The human-readable identifier for the issue. This field is unique per-domain, and can be used to correlate this issue snapshot item to the underlying issue across different snapshots.
      - `issueId` string, required — The globally unique identifier for the underlying issue across snapshots. This field can be used to correlate this snapshot item to the underlying issue across different snapshots.
      - `snapshotId` string, required — The identifier for the snapshot this issue item belongs to.
      - `dueDate` string, date-time, nullable — The due date for the issue.
      - `status` 'IN_PROGRESS' | 'NOT_STARTED' | 'CLOSED'
      - `lastModifiedAt` string, date-time — The date and time when the issue was last modified.
      - `createdAt` string, date-time — The date and time when the issue was created.
      - `detectedAt` string, date-time — The date and time when the issue was detected.
    - `pageInfo` PageInfo, required — Provides information about the pagination of a dataset.
      - `endCursor` string, nullable, required — The cursor that points to the end of the current page, or null if there is no such cursor.
      - `hasNextPage` boolean, required — Indicates if there is another page after the current page.
      - `hasPreviousPage` boolean, required — Indicates if there is a page before the current page.
      - `startCursor` string, nullable, required — The cursor that points to the start of the current page, or null if there is no such cursor.

---

[API](https://skmtc.net/vanta/apis/build-integrations.md) · [All operations](https://skmtc.net/vanta/apis/build-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vanta/build-integrations/versions/6c1f7590538b/schema)