> ## 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 monitored computers > Returns a list of computers monitored by an MDM (with an integration built by Vanta) or by Vanta Device Monitor. Currently this list does not include resources from partner or customer-built integrations. End of life — this endpoint works for classic audits only; it does not support controlled audit view. It remains available for existing classic audits but will be removed once classic audits are fully phased out, so do not build new integrations on it. Rate limit: 10 requests / minute. ## OpenAPI ````yaml https://spec.speakeasy.com/vanta/vanta/conduct-an-audit-with-code-samples get /audits/{auditId}/monitored-computers 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}/monitored-computers: get: tags: - Audits summary: List monitored computers description: >- Returns a list of computers monitored by an MDM (with an integration built by Vanta) or by Vanta Device Monitor. Currently this list does not include resources from partner or customer-built integrations. End of life — this endpoint works for classic audits only; it does not support controlled audit view. It remains available for existing classic audits but will be removed once classic audits are fully phased out, so do not build new integrations on it. Rate limit: 10 requests / minute. operationId: ListMonitoredComputersInAuditScope parameters: - in: path name: auditId required: true schema: type: string - in: query name: pageSize required: false schema: $ref: '#/components/schemas/PageSize' - in: query name: pageCursor required: false schema: $ref: '#/components/schemas/PageCursor' - description: >- Filters for monitored computers matching any status declared in the filter. in: query name: complianceStatusFilterMatchesAny required: false schema: type: array items: $ref: '#/components/schemas/ComputerStatusFilter' responses: '200': description: Ok content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_MonitoredComputer_' examples: Example 1: value: results: data: - id: 5f2c939a52855e725c8d5823 integrationId: vantaAgent serialNumber: FVFGPGV2Q6L5 udid: 280FF071-1D7A-5752-BD3A-1A68937CD187 lastCheckDate: '2024-03-07T18:46:05.944Z' screenlock: outcome: FAIL diskEncryption: outcome: FAIL passwordManager: outcome: FAIL antivirusInstallation: outcome: FAIL operatingSystem: type: macOS version: 13.2.1 owner: id: 65e1efde08e8478f143a8ff9 emailAddress: example-person@email.com displayName: Example Owner pageInfo: hasNextPage: false hasPreviousPage: false startCursor: 5f2c939a52855e725c8d5823 endCursor: 5f2c939a52855e725c8d5823 deprecated: true security: - bearerAuth: [] 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. ComputerStatusFilter: description: >- Enum representing computer compliance statuses that can be utilized as a filter. The meanings are as follows: AV_NOT_INSTALLED: The computer does not have antivirus software installed. HD_NOT_ENCRYPTED: The computer's harddrive is not encrypted. LAST_CHECK_OVER_14_DAYS: No data has been received from computer for over 14 days. PWM_NOT_INSTALLED: The computer does not have a password manager installed. SCREENLOCK_NOT_CONFIGURED: The computer does not have screenlock configured appropriately. enum: - PWM_NOT_INSTALLED - HD_NOT_ENCRYPTED - AV_NOT_INSTALLED - SCREENLOCK_NOT_CONFIGURED - LAST_CHECK_OVER_14_DAYS type: string PaginatedResponse_MonitoredComputer_: properties: results: properties: data: items: $ref: '#/components/schemas/MonitoredComputer' type: array pageInfo: $ref: '#/components/schemas/PageInfo' required: - data - pageInfo type: object required: - results type: object additionalProperties: false MonitoredComputer: properties: id: type: string description: Unique identifier for the monitored computer. integrationId: type: string description: >- Hard-coded enums for Vanta-built integrations or application IDs for 3rd-party-built integrations. lastCheckDate: type: string format: date-time nullable: true description: Date of the computer's most recent report. screenlock: $ref: '#/components/schemas/ComputerStatus' description: Whether or not the computer has screenlock enabled. diskEncryption: $ref: '#/components/schemas/ComputerStatus' description: Whether or not the computer's hard drive is encrypted. passwordManager: $ref: '#/components/schemas/ComputerStatus' description: Whether or not the computer has a password manager installed. antivirusInstallation: $ref: '#/components/schemas/ComputerStatus' description: Whether or not the computer has antivirus software installed. operatingSystem: allOf: - $ref: '#/components/schemas/OperatingSystem' nullable: true description: The computer's operating system name and version. owner: allOf: - $ref: '#/components/schemas/Owner' nullable: true description: >- The name, unique identifier, and email address of the computer's owner. serialNumber: type: string nullable: true description: >- The serial number of the computer. This value may be null if it is not reported by the device. udid: type: string nullable: true description: The universal device id of the computer. required: - id - integrationId - lastCheckDate - screenlock - diskEncryption - passwordManager - antivirusInstallation - operatingSystem - owner - serialNumber - udid 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 ComputerStatus: description: >- The a status check for a computer. Representation for screenlock, diskEncryption, passwordManager, and antivirusInstallation. properties: outcome: $ref: '#/components/schemas/ComputerStatusOutcome' description: The outcome of the status check. required: - outcome type: object additionalProperties: false OperatingSystem: description: The computer's operating system type and version. properties: type: $ref: '#/components/schemas/OperatingSystemType' description: The type of the operating system. version: type: string nullable: true description: The version of the operating system. required: - type - version type: object additionalProperties: false Owner: properties: id: type: string description: Unique identifier for the person. displayName: type: string description: Name of the person that is shown in product. emailAddress: type: string description: Email address of the person. required: - id - displayName - emailAddress type: object additionalProperties: false ComputerStatusOutcome: description: >- The possible outcomes of a status check. The outcome can be one of the following: FAIL: The check is failing. IN_PROGRESS: The check needs further data from the given computer in order to evaluate. The field(s) needed from a computer to calculate the ComputerStatusOutcome were null. NA: The check is not applicable for the given computer. PASS: The check is passing. enum: - FAIL - IN_PROGRESS - NA - PASS type: string OperatingSystemType: description: >- The possible types of the operating system. One of `mac_OS`, `linux`, or `windows`. enum: - macOS - linux - windows type: string securitySchemes: bearerAuth: type: http scheme: bearer ````