---
title: "List audits"
method: GET
path: "/audits"
tags: ["Audits"]
---

# List audits

`GET /audits`

Returns a paginated list of audits scoped to the audit firm.

To identify IRL (Information Request List) audits, check for the presence of the
`auditorRequestListMetadata` field. This field is only present for IRL-based audits
and will be `undefined` for standard audits.

Rate limit: 250 requests / minute.

## Query parameters

- `pageSize` integer — Controls the maximum number of items returned in one response from the listAudits API. We have increased the pagination size for this endpoint to enable our upmarket audit firms to sync in a timely manner. The rest of the API will use a pagination size of 100.
- `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
- `isActiveAudit` boolean

## Response `200`

Ok

- PaginatedResponseAudit
  - `results` object, required
    - `data` Audit[], required
      - `id` string, required — The unique identifier for the audit.
      - `customerOrganizationName` string, required — The domain name of the customer organization being audited (e.g. vanta.com)
      - `customerDisplayName` string, nullable, required — The human readable name of the customer organization being audited (e.g. Vanta)
      - `customerOrganizationId` string, required — The uuid of the customer organization being audited
      - `auditStartDate` string, date-time, required — The start of the audit window. This is also when data collection for audit starts.
      - `auditEndDate` string, date-time, required — The end of the audit window.
      - `earlyAccessStartsAt` string, date-time, nullable, required — Timestamp at which auditors gain access to the audit. Occurs before the audit window begins
      - `framework` string, required — The name of the framework for the audit
      - `displayName` string, required — The display name for the audit. Returns the custom audit name if set, otherwise returns the framework name.
      - `allowAuditorEmails` string[], required — Emails of auditors with access to audit
      - `allowAllAuditors` boolean, required — Set to true if all auditors in audit firm have access
      - `deletionDate` string, date-time, nullable, required — Timestamp when the audit was deleted
      - `creationDate` string, date-time, required — Timestamp when the audit was created
      - `modificationDate` string, date-time, nullable, required — Timestamp when the audit was updated
      - `completionDate` string, date-time, nullable, required — Timestamp when the audit was marked completed, and report was uploaded
      - `auditFocus` 'EXTERNAL' | 'INTERNAL', required
      - `auditorRequestListMetadata` object — Metadata about the auditor request list. This field is only present for IRL (Information Request List) based audits and will be undefined for standard audits. Use the presence of this field to differentiate between IRL and non-IRL audits.
        - `requestsSharedWithCustomer` string, date-time, nullable, required — Timestamp when information requests were shared with the customer. Null if not shared.
    - `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)