---
title: "List audit comments"
method: GET
path: "/audits/{auditId}/comments"
tags: ["Audits"]
---

# List audit comments

`GET /audits/{auditId}/comments`

Returns a paginated list of comments for an audit.

Rate limit: 250 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.
- `changedSinceDate` string, date-time

## Response `200`

Ok

- PaginatedResponseComment
  - `results` object, required
    - `data` Comment[], required
      - `id` string, required — The unique identifier for the comment
      - `auditEvidenceId` string, required — The unique identifier for the audit evidence related to the comment.
      - `text` string, required — The comment message
      - `creationDate` string, date-time, required — When the comment was created
      - `modificationDate` string, date-time, nullable, required — When the comment was updated
      - `deletionDate` string, date-time, nullable, required — When the comment was deleted
      - `email` string, nullable, required — The email of the comment author. This acts as a unique identifier to map users between Vanta and external systems.
      - `authorName` string, nullable, required — Human-readable display name of the comment author. Null if the author's name is not available (e.g., user was deleted). This enables correct author attribution in integrations where users cannot be reliably matched across systems by email alone.
    - `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)