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

# List audit evidence url

`GET /audits/{auditId}/evidence/{auditEvidenceId}/urls`

Returns a paginated list of evidence urls for an audit. This endpoint should be called whenever an
evidence is created or has a statusUpdatedAt field that is more recent than the most recent polling event.

Evidence must be in one of the following states to retrieve URLs: "Ready for audit", "Accepted", "Flagged", or "NA".

Rate limit: 600 requests / minute.

## Path parameters

- `auditId` string, required
- `auditEvidenceId` 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`

Ok

- PaginatedResponseEvidenceUrl
  - `results` object, required
    - `data` EvidenceUrl[], required
      - `id` string, required — Vanta internal reference to evidence
      - `url` string, required — Pre-signed S3 URL for evidence
      - `filename` string, required — File name of evidence
      - `isDownloadable` boolean, required — Set to true if this is a presigned s3 url. Set to false if this is a customer uploaded link
      - `mimeType` string, nullable, required — MIME type of the evidence file (e.g., "application/pdf", "image/png")
    - `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)