---
title: "List managed devices"
method: GET
path: "/v1/devices"
tags: ["Devices"]
---

# List managed devices

`GET /v1/devices`

List managed employee devices with endpoint compliance status, ownership, and security check results for workforce controls.

## Response `200`

Devices retrieved successfully

- object
  - `data` DeviceResponseDto[]
    - `created_at` string, required — Device created at
    - `updated_at` string, required — Device updated at
    - `software` object[], required — Software list
    - `software_updated_at` string, required — Software updated at
    - `id` union, required — Device ID (numeric for Fleet devices, string UUID for device-agent devices)
      - number
      - string
    - `detail_updated_at` string, required — Detail updated at
    - `label_updated_at` string, required — Label updated at
    - `policy_updated_at` string, required — Policy updated at
    - `last_enrolled_at` string, required — Last enrolled at
    - `seen_time` string, required — Last seen time
    - `refetch_requested` boolean, required — Refetch requested
    - `hostname` string, required — Hostname
    - `uuid` string, required — Device UUID
    - `platform` string, required — Platform
    - `osquery_version` string, required — Osquery version
    - `orbit_version` string, required — Orbit version
    - `fleet_desktop_version` string, required — Fleet desktop version
    - `scripts_enabled` boolean, required — Scripts enabled
    - `os_version` string, required — OS version
    - `build` string, required — Build
    - `platform_like` string, required — Platform like
    - `code_name` string, required — Code name
    - `uptime` number, required — Uptime in seconds
    - `memory` number, required — Memory in bytes
    - `cpu_type` string, required — CPU type
    - `cpu_subtype` string, required — CPU subtype
    - `cpu_brand` string, required — CPU brand
    - `cpu_physical_cores` number, required — CPU physical cores
    - `cpu_logical_cores` number, required — CPU logical cores
    - `hardware_vendor` string, required — Hardware vendor
    - `hardware_model` string, required — Hardware model
    - `hardware_version` string, required — Hardware version
    - `hardware_serial` string, required — Hardware serial
    - `computer_name` string, required — Computer name
    - `public_ip` string, required — Public IP
    - `primary_ip` string, required — Primary IP
    - `primary_mac` string, required — Primary MAC
    - `distributed_interval` number, required — Distributed interval
    - `config_tls_refresh` number, required — Config TLS refresh
    - `logger_tls_period` number, required — Logger TLS period
    - `team_id` object, nullable, required — Team ID
    - `pack_stats` object[], required — Pack stats
    - `team_name` object, nullable, required — Team name
    - `users` object[], required — Users
    - `gigs_disk_space_available` number, required — Disk space available in GB
    - `percent_disk_space_available` number, required — Percent disk space available
    - `gigs_total_disk_space` number, required — Total disk space in GB
    - `disk_encryption_enabled` boolean, required — Disk encryption enabled
    - `issues` object, required — Issues
    - `mdm` object, required — MDM info
    - `refetch_critical_queries_until` object, nullable, required — Refetch critical queries until
    - `last_restarted_at` string, required — Last restarted at
    - `policies` FleetPolicyDto[], required — Policies
      - `id` number, required — Policy ID
      - `name` string, required — Policy name
      - `query` string, required — Policy query
      - `critical` boolean, required — Whether policy is critical
      - `description` string, required — Policy description
      - `author_id` number, required — Author ID
      - `author_name` string, required — Author name
      - `author_email` string, required — Author email
      - `team_id` object, nullable, required — Team ID
      - `resolution` string, required — Policy resolution
      - `platform` string, required — Platform
      - `calendar_events_enabled` boolean, required — Calendar events enabled
      - `created_at` string, required — Created at
      - `updated_at` string, required — Updated at
      - `response` string, required — Policy response
    - `labels` object[], required — Labels
    - `packs` object[], required — Packs
    - `batteries` object[], required — Batteries
    - `end_users` object[], required — End users
    - `last_mdm_enrolled_at` string, required — Last MDM enrolled at
    - `last_mdm_checked_in_at` string, required — Last MDM checked in at
    - `status` string, required — Device status
    - `display_text` string, required — Display text
    - `display_name` string, required — Display name
  - `count` number — Total number of devices
  - `authType` 'api-key' | 'session' — How the request was authenticated
  - `authenticatedUser` object
    - `id` string — User ID
    - `email` string — User email

## Other responses

- `401` — Unauthorized - Invalid authentication or insufficient permissions
- `404` — Organization not found
- `500` — Internal server error - FleetDM integration issue

---

[API](https://skmtc.net/trycompai/apis/comp-ai-api.md) · [All operations](https://skmtc.net/trycompai/apis/comp-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trycompai/comp-ai-api/versions/726b9523fb22/schema)