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

# List audit evidence

`GET /audits/{auditId}/evidence`

Returns a paginated list of evidence 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

- PaginatedResponseEvidence
  - `results` object, required
    - `data` Evidence[], required
      - `id` string, required — Vanta internal reference to evidence
      - `externalId` string, required — This is a static UUID to map Audit Firm controls to Vanta controls
      - `status` 'Accepted' | 'Flagged' | 'Initialized' | 'NA' | 'Not ready for audit' | 'Ready for audit', required
      - `name` string, required — Mutable name for evidence. Not guaranteed to be unique.
      - `deletionDate` string, date-time, nullable, required — The date this Audit Evidence was deleted
      - `creationDate` string, date-time, required — The date this Audit Evidence was created
      - `statusUpdatedDate` string, date-time, required — Point in time that status was last updated
      - `testStatus` string, nullable, required — The outcome of the automated test run, for Test-type evidence
      - `evidenceType` 'Evidence Request' | 'Policy' | 'Test', required
      - `evidenceId` string, required — Unique identifier for evidence
      - `relatedControls` EvidenceControl[], required — The controls associated to this evidence
        - `name` string, required — Name of control associated to this evidence
        - `sectionNames` string[], required — A list sections associated to the control
      - `description` string, nullable, required — The description for the evidence. It will be set to null if the evidence is deleted
    - `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)