Retrieves the list of Unique Devices Detected in the Network.

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

This API lists all unique devices discovered within your network. It supports filters for OS platform, device type, and block status.

Request URL

https://{serverurl}/api/1.4/reports/dcm/devicesummary Copied!

Scope

DesktopCentralCloud.DeviceControl.READCopied!

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Query Parameters

pageintegerOptional

Current page number for pagination

pagelimitintegerOptional

Number of records per page

isblockedintegerOptional

0 - Allowed (device is permitted)
1 - Blocked (device access is restricted)

os_platformstringOptional

1 - Windows
2 - Mac

devicetypelongOptional

2 - Biometric
3 - Bluetooth
4 - CD-ROM
5 - Disk Drive
9 - Floppy Disk
19 - Imaging Device
20 - Infrared
21 - Keyboard
24 - Modem
26 - Mouse
37 - Printer
42 - Smart Card Reader
46 - Tape Drive
49 - WPD
100 - WPD Apple Devices
102 - Serial Ports (COM)
103 - Parallel Ports (LPT)
104 - Wireless Network Adapters

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomains/api/1.4/reports/dcm/devicesummary \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'

Response Parameters

- HTTP code 200

Response Body - application/json
string

Sample Response: HTTP 200

Device summary report response with pagination

Copied!
  {
    "response_code": 200,
    "message_type": "dcm",
    "message_response": {
      "total": 1,
      "limit": 25,
      "page": 1,
      "dcm": [
        {
          "custom_device_name": "--",
          "deviceaudit_id": 17708,
          "device_removed_time": 1756102055000,
          "managedcomputer.friendly_name": "John",
          "vendor_hex_id": "0781",
          "os_platform": 1,
          "vendor_name": "SanDisk Corp.",
          "device_type": "smp.dcm.removablestoragedevice",
          "serial_number": "04015160df32980ed07728df07b1a1c737c3aff5aab42687e3a3fafcf59e155b587111100000000000000026af6cefff9d8118ab5581077e2d235c5c",
          "connected_count": 9,
          "userresource.name": "John",
          "product_name": "Unknown",
          "deviceauditevents.target_device_name": "USB  SanDisk 3.2Gen1 USB Device",
          "is_blocked": 1,
          "product_hex_id": "55ab",
          "last_occurrence": 1756102055000,
          "device_inserted_time": 1756102055000,
          "resource_name": "John",
          "usage_duration": 0,
          "computer_resource_id": 111301,
          "db_updated_time": 1756102068943,
          "deviceauditevents.target_manufacturer_name": "(Standard disk drives)"
        }
      ]
    },
    "message_version": "1.4",
    "status": "success"
  }
                
▼ Show full