---
title: "List risk snapshots for an audit"
method: GET
path: "/audits/{auditId}/risks/snapshots"
tags: ["Audits"]
---

# List risk snapshots for an audit

`GET /audits/{auditId}/risks/snapshots`

Returns a paginated list of risk assessment snapshots available for an audit.

Risk snapshots capture the state of an organization's risk register at a
point in time. Each snapshot has an `id` that can be used with the
`/audits/{auditId}/risks` endpoint to retrieve the individual risk
scenarios within that snapshot.

Results are sorted by creation date (newest first). This sort order is
fixed and cannot be customized via query parameters. Only snapshots
that are shared with auditors are included.

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.

## Response `200`

Paginated list of risk snapshots with pagination metadata

- PaginatedResponseRiskSnapshot
  - `results` object, required
    - `data` RiskSnapshot[], required
      - `id` string, required — Unique identifier for the risk snapshot.
      - `createdAt` string, date-time, required — The date and time when this risk snapshot was created.
    - `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/revisions/6c1f7590538b/schema)