---
title: "List monitored computers"
method: GET
path: "/audits/{auditId}/monitored-computers"
tags: ["Audits"]
deprecated: true
---

# List monitored computers

`GET /audits/{auditId}/monitored-computers`

> **Deprecated.**

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.

## 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.
- `complianceStatusFilterMatchesAny` ComputerStatusFilter[]

## Response `200`

Ok

- PaginatedResponseMonitoredComputer
  - `results` object, required
    - `data` MonitoredComputer[], required
      - `id` string, required — Unique identifier for the monitored computer.
      - `integrationId` string, required — Hard-coded enums for Vanta-built integrations or application IDs for 3rd-party-built integrations.
      - `lastCheckDate` string, date-time, nullable, required — Date of the computer's most recent report.
      - `screenlock` ComputerStatus, required — The a status check for a computer. Representation for screenlock, diskEncryption, passwordManager, and antivirusInstallation.
        - `outcome` 'FAIL' | 'IN_PROGRESS' | 'NA' | 'PASS', required — 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.
      - `diskEncryption` ComputerStatus, required — The a status check for a computer. Representation for screenlock, diskEncryption, passwordManager, and antivirusInstallation.
        - `outcome` 'FAIL' | 'IN_PROGRESS' | 'NA' | 'PASS', required — 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.
      - `passwordManager` ComputerStatus, required — The a status check for a computer. Representation for screenlock, diskEncryption, passwordManager, and antivirusInstallation.
        - `outcome` 'FAIL' | 'IN_PROGRESS' | 'NA' | 'PASS', required — 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.
      - `antivirusInstallation` ComputerStatus, required — The a status check for a computer. Representation for screenlock, diskEncryption, passwordManager, and antivirusInstallation.
        - `outcome` 'FAIL' | 'IN_PROGRESS' | 'NA' | 'PASS', required — 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.
      - `operatingSystem` OperatingSystem, required — The computer's operating system type and version.
        - `type` 'macOS' | 'linux' | 'windows', required — The possible types of the operating system. One of `mac_OS`, `linux`, or `windows`.
        - `version` string, nullable, required — The version of the operating system.
      - `owner` Owner, required
        - `id` string, required — Unique identifier for the person.
        - `displayName` string, required — Name of the person that is shown in product.
        - `emailAddress` string, required — Email address of the person.
      - `serialNumber` string, nullable, required — The serial number of the computer. This value may be null if it is not reported by the device.
      - `udid` string, nullable, required — The universal device id of the computer.
    - `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)