> ## Documentation Index > Fetch the complete documentation index at: https://developer.vanta.com/llms.txt > Use this file to discover all available pages before exploring further. # List integrations for an audit > Retrieves integration population data for an audit. This endpoint provides access to integration records visible to auditors during an audit engagement. Integrations represent connected services (e.g., GitHub, AWS, Slack) that provide data for the audit. Supports filtering by: - `search`: Searches integration names (case-insensitive) - `tagsMatchesAny`: Filters by integration tag (ACCESS, COMPUTERS, etc.) - `categoriesMatchesAny`: Filters by category (CLOUD_PROVIDER, HR_PROVIDER, etc.) 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 Results are sorted by integration display name (ascending). This sort order is fixed and cannot be customized via query parameters. Rate limit: 10 requests / minute. ## OpenAPI ````yaml https://spec.speakeasy.com/vanta/vanta/conduct-an-audit-with-code-samples get /audits/{auditId}/integrations openapi: 3.0.0 info: title: Conduct an audit version: 1.0.0 description: >- The Auditor API lets audit firms conduct audits from a tool outside of Vanta. Unlock data syncing with Vanta through this API. **Note for Vanta Gov (FedRAMP) customers:** Select `Vanta Gov (FedRAMP)` from the server dropdown to issue requests against `https://api.vanta-gov.com`. The OAuth token URL shown below defaults to the commercial host — replace it with `https://api.vanta-gov.com/oauth/token`. termsOfService: https://www.vanta.com/terms license: name: UNLICENSED contact: name: API Support url: https://help.vanta.com/ email: support@vanta.com servers: - url: https://api.vanta.com/v1 description: US Region API - url: https://api.vanta-gov.com/v1 description: Vanta Gov (FedRAMP) security: [] paths: /audits/{auditId}/integrations: get: tags: - Audits summary: List integrations for an audit description: >- Retrieves integration population data for an audit. This endpoint provides access to integration records visible to auditors during an audit engagement. Integrations represent connected services (e.g., GitHub, AWS, Slack) that provide data for the audit. Supports filtering by: - `search`: Searches integration names (case-insensitive) - `tagsMatchesAny`: Filters by integration tag (ACCESS, COMPUTERS, etc.) - `categoriesMatchesAny`: Filters by category (CLOUD_PROVIDER, HR_PROVIDER, etc.) 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 Results are sorted by integration display name (ascending). This sort order is fixed and cannot be customized via query parameters. Rate limit: 10 requests / minute. operationId: ListIntegrations parameters: - description: The audit ID in: path name: auditId required: true schema: type: string - description: Maximum number of results per page (1-100, default 10) in: query name: pageSize required: false schema: $ref: '#/components/schemas/PageSize' - description: Pagination cursor from previous response in: query name: pageCursor required: false schema: $ref: '#/components/schemas/PageCursor' - description: Search term for filtering by integration name in: query name: search required: false schema: type: string - description: Filter integrations by tag values in: query name: tagsMatchesAny required: false schema: type: array items: $ref: '#/components/schemas/AuditIntegrationTag' - description: Filter integrations by category values in: query name: categoriesMatchesAny required: false schema: type: array items: $ref: '#/components/schemas/AuditIntegrationCategory' responses: '200': description: Paginated list of integrations with pagination metadata content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_AuditIntegration_' examples: Example 1: value: results: pageInfo: hasNextPage: true hasPreviousPage: false startCursor: github endCursor: github data: - id: github name: GitHub tags: - Vulnerabilities - Code changes categories: - Version control systems security: - bearerAuth: [] x-codeSamples: - lang: typescript label: ListIntegrations source: |- import { Vanta } from "vanta-auditor-api-sdk"; const vanta = new Vanta({ bearerAuth: process.env["VANTA_BEARER_AUTH"] ?? "", }); async function run() { const result = await vanta.audits.listIntegrations({ auditId: "", }); console.log(result); } run(); - lang: java label: ListIntegrations source: >- package hello.world; import com.vanta.vanta_auditor_api.Vanta; import com.vanta.vanta_auditor_api.models.operations.ListIntegrationsRequest; import com.vanta.vanta_auditor_api.models.operations.ListIntegrationsResponse; import java.lang.Exception; public class Application { public static void main(String[] args) throws Exception { Vanta sdk = Vanta.builder() .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", "")) .build(); ListIntegrationsRequest req = ListIntegrationsRequest.builder() .auditId("") .build(); ListIntegrationsResponse res = sdk.audits().listIntegrations() .request(req) .call(); if (res.paginatedResponseAuditIntegration().isPresent()) { System.out.println(res.paginatedResponseAuditIntegration().get()); } } } components: schemas: PageSize: type: integer format: int32 default: 10 description: >- Controls the maximum number of items returned in one response from the API. minimum: 1 maximum: 100 PageCursor: type: string description: >- 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. AuditIntegrationTag: enum: - ACCESS - COMPUTERS - CUSTOM_RESOURCE - DATA_LOSS_PREVENTION - DOCUMENTS - DOCUMENT_UPLOAD - FRAMEWORK - GROUPS - INVENTORY - NOTIFICATIONS - PEOPLE - POLICIES - SECURITY_AWARENESS_TRAINING - SECURITY_SCANNER_ALERTS - SSO - TASK_CREATION - TASK_TRACKING - TRUST_CENTER - VENDOR_DISCOVERY - VENDOR_PROCUREMENT - VULNERABILITIES type: string AuditIntegrationCategory: enum: - ATS_MERGE_ACCOUNT - BACKGROUND_CHECK_SERVICE - CLOUD_PROVIDER - COMMUNICATION_PLATFORM - CRM_MERGE_ACCOUNT - CRM_PLATFORM - DATASTORE_PROVIDER - DATA_LOSS_PREVENTION - DATA_WAREHOUSE_PROVIDER - DOCUMENT_MANAGEMENT_TOOL - ENDPOINT_SECURITY_TOOL - HR_PROVIDER - IDENTITY_PROVIDER - INCIDENT_MANAGEMENT_TOOL - MOBILE_DEVICE_MANAGEMENT_TOOL - MONITORING_SERVICE - OTHER_INTEGRATION - SECURITY_AWARENESS_TRAINING_PROVIDER - SECURITY_SCANNER_ALERTS - TASK_TRACKER - VERSION_CONTROL_SYSTEM - VULNERABILITY_SCANNER type: string PaginatedResponse_AuditIntegration_: properties: results: properties: data: items: $ref: '#/components/schemas/AuditIntegration' type: array pageInfo: $ref: '#/components/schemas/PageInfo' required: - data - pageInfo type: object required: - results type: object additionalProperties: false AuditIntegration: description: |- Integration row returned by the auditor integrations API. `id` and `name` are always present. Other fields are optional to support controlled audits where only approved columns are returned. properties: id: type: string description: Integration identifier. example: github name: type: string description: Display name of the integration. example: GitHub tags: items: type: string type: array description: >- Integration tag display names describing what data this integration provides. example: - Vulnerabilities - Code changes categories: items: type: string type: array description: Category display names describing what the integration is used for. example: - Version control systems required: - id - name type: object additionalProperties: false PageInfo: description: Provides information about the pagination of a dataset. properties: endCursor: type: string nullable: true description: >- The cursor that points to the end of the current page, or null if there is no such cursor. hasNextPage: type: boolean description: Indicates if there is another page after the current page. hasPreviousPage: type: boolean description: Indicates if there is a page before the current page. startCursor: type: string nullable: true description: >- The cursor that points to the start of the current page, or null if there is no such cursor. required: - endCursor - hasNextPage - hasPreviousPage - startCursor type: object additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer ````