---
title: "List monitored computers"
method: GET
path: "/monitored-computers"
tags: ["Monitored Computers"]
---

# List monitored computers

`GET /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.

## 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/revisions/6c1f7590538b/schema)