v56

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014121451.1 MB
Devices

List managed devices

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

get/v1/devices

Response

Devices retrieved successfully

countnumber

Total number of devices

authType'api-key' | 'session'

How the request was authenticated

Example response

{
  "data": [
    {
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-15T00:00:00Z",
      "software_updated_at": "2024-01-10T00:00:00Z",
      "id": 123,
      "detail_updated_at": "2024-01-10T00:00:00Z",
      "label_updated_at": "2024-01-10T00:00:00Z",
      "policy_updated_at": "2024-01-10T00:00:00Z",
      "last_enrolled_at": "2024-01-01T00:00:00Z",
      "seen_time": "2024-01-15T12:00:00Z",
      "hostname": "johns-macbook",
      "uuid": "abc123def456",
      "platform": "darwin",
      "osquery_version": "5.10.2",
      "orbit_version": "1.19.0",
      "fleet_desktop_version": "1.19.0",
      "scripts_enabled": true,
      "os_version": "macOS 14.2.1",
      "build": "23C71",
      "platform_like": "darwin",
      "code_name": "sonoma",
      "uptime": 86400,
      "memory": 17179869184,
      "cpu_type": "x86_64",
      "cpu_subtype": "x86_64h",
      "cpu_brand": "Intel(R) Core(TM) i7-9750H",
      "cpu_physical_cores": 6,
      "cpu_logical_cores": 12,
      "hardware_vendor": "Apple Inc.",
      "hardware_model": "MacBookPro16,1",
      "hardware_version": "1.0",
      "hardware_serial": "C02XW0AAJGH6",
      "computer_name": "John's MacBook Pro",
      "public_ip": "203.0.113.1",
      "primary_ip": "192.168.1.100",
      "primary_mac": "00:11:22:33:44:55",
      "distributed_interval": 10,
      "config_tls_refresh": 3600,
      "logger_tls_period": 300,
      "gigs_disk_space_available": 250.5,
      "percent_disk_space_available": 75.2,
      "gigs_total_disk_space": 500,
      "disk_encryption_enabled": true,
      "last_restarted_at": "2024-01-10T08:00:00Z",
      "policies": [
        {
          "id": 123,
          "name": "Password Policy",
          "query": "SELECT * FROM users;",
          "critical": true,
          "description": "Ensures strong passwords",
          "author_id": 456,
          "author_name": "John Doe",
          "author_email": "john@example.com",
          "resolution": "Update password settings",
          "platform": "darwin",
          "created_at": "2024-01-01T00:00:00Z",
          "updated_at": "2024-01-15T00:00:00Z",
          "response": "compliant"
        }
      ],
      "last_mdm_enrolled_at": "2024-01-01T00:00:00Z",
      "last_mdm_checked_in_at": "2024-01-15T12:00:00Z",
      "status": "online",
      "display_text": "Johns MacBook Pro",
      "display_name": "John's MacBook Pro"
    }
  ],
  "count": 25,
  "authenticatedUser": {
    "id": "usr_abc123def456",
    "email": "user@company.com"
  }
}