Retrieves a list of all Blocked Devices within 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 provides detailed information about all devices that have been blocked across the network. It supports filters for OS platform, device type, domain, computer/group, and specific time periods.

Request URL

https://{serverurl}/api/1.4/reports/dcm/blockdeviceaudit

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
1 - Blocked

os_platformstringOptional

1 - Windows
2 - Mac

devicetypelongOptional

2 - Biometric
3 - Bluetooth
4 - CD-ROM
5 - Disk Drive
9 - Floppy Disk
19 - Image
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 Adapters

dipIdstringOptional

Filter records based on device instance path

periodintegerOptional

Filter by time range
0 - This week
1 - This month
2 - This year
3 - Last week
4 - Last month
5 - Last 2 months
6 - Last 3 months
7 - Last 6 months
8 - Last 9 months
9 - Last year

domainstringOptional

Filter the records based on domain names

computerlongOptional

Filter devices connected to a particular computer. Resource IDs can be obtained from /api/1.0/som/computers

userlongOptional

Filter by user resource ID

gidlongOptional

Filter devices connected to a particular group of computers. Group IDs can be obtained from /api/1.4/customgroup/getCGList

Sample Request

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

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Hide Sub-Attributes
message_typestring

Module code identifier

message_responseJSON Object

Response data container

Show Sub-Attributes
totalinteger

Total number of records

limitinteger

Maximum number of records in this response

pageinteger

Current page number

dcmJSON Array

Array of blocked device records

Show Sub-Attributes
JSON Object
Show Sub-Attributes
deviceaudit_idinteger

Unique ID for device audit entry

custom_device_namestring

User-defined device name

vendor_namestring

Device manufacturer name

vendor_hex_idstring

Device vendor hexadecimal code

product_namestring

Device product name

product_hex_idstring

Device product hexadecimal code

serial_numberstring

Unique hardware serial number

device_typestring

Type of device (USB, removable storage, etc.)

deviceauditevents.target_device_namestring

Display name of device

deviceauditevents.target_manufacturer_namestring

Manufacturer from OS

device_inserted_timelong

Timestamp when device was inserted

device_removed_timelong

Timestamp when device was removed

is_blockedinteger

Whether device was blocked (1=yes, 0=no)

usage_durationinteger

Duration of device usage (ms)

class_guidstring

Windows device class identifier

managedcomputer.friendly_namestring

Hostname/friendly name of the computer

computer_resource_idinteger

Internal resource ID of machine

resource_namestring

Computer name

userresource.namestring

Logged-in username

domain_netbios_namestring

Domain/workgroup

os_platforminteger

Operating system platform (1=Windows, 2=Mac)

customer_idinteger

Customer identifier

db_updated_timelong

Last DB update timestamp

message_versionstring

API version

statusstring

Status of API call (success/failure)

response_codeinteger

HTTP response code

Possible Response Codes

200HTTP code

Sample Response: HTTP 200

Blocked devices report response

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": "04015160df32988ed07728df07b1a1c737c3aff5aab42687e3a3fafcf59e155b5871111000000000000000026af6cefff9d8118ab5581077e2d235c",
          "domain_netbios_name": "WORKGROUP",
          "userresource.name": "John",
          "product_name": "Unknown",
          "deviceauditevents.target_device_name": "USB  SanDisk 3.2Gen1 USB Device",
          "is_blocked": 1,
          "product_hex_id": "55ab",
          "device_inserted_time": 1756102055000,
          "resource_name": "John",
          "customer_id": 1,
          "class_guid": "{4d36e967-e325-11ce-bfc1-08002be10318}",
          "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