Retrieves Device Status Details for all Windows Computers 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 fetches the status of devices connected to each Windows computer within your network. It supports pagination and returns status indicators for every connected device.

Request URL

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

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

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomains/api/1.4/reports/dcm/computerdevstatus \
  --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 computer device status records

Show Sub-Attributes
JSON Object
Show Sub-Attributes
biometric.status_idinteger

Biometric device status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

wirelessnetworkadapters.status_idinteger

Wireless network adapter status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

smartcardreader.status_idinteger

Smart card reader status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

wpd.status_idinteger

Windows Portable Device status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

bluetooth.status_idinteger

Bluetooth status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

modem.status_idinteger

Modem status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

serialports.status_idinteger

Serial ports status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

parallelports.status_idinteger

Parallel ports status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

infrared.status_idinteger

Infrared status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

printer.status_idinteger

Printer status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

floppydisk.status_idinteger

Floppy disk status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

image.status_idinteger

Image device status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

cdrom.status_idinteger

CD-ROM status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

diskdrive.status_idinteger

Disk drive status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

mouse.status_idinteger

Mouse status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

tapedrive.status_idinteger

Tape drive status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

appledevices.status_idinteger

Apple devices status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

keyboard.status_idinteger

Keyboard status (0=Blocked, 1=Allowed, 2=Read-only, 4=No Change)

resource_idinteger

Unique resource ID

resource_id_stringstring

Unique resource ID (string format)

resource_namestring

Computer name

managedcomputer.friendly_namestring

Computer friendly name

domain_netbios_namestring

Domain/workgroup

agent_logged_on_usersstring

Users logged into agent

os_platforminteger

OS identifier (1=Windows, 2=Mac)

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

Computer device status report response

Copied!
  {
    "response_code": 200,
    "message_type": "dcm",
    "message_response": {
      "total": 1,
      "limit": 25,
      "page": 1,
      "dcm": [
        {
          "biometric.status_id": 4,
          "wirelessnetworkadapters.status_id": 4,
          "smartcardreader.status_id": 4,
          "wpd.status_id": 4,
          "bluetooth.status_id": 4,
          "domain_netbios_name": "WORKGROUP",
          "modem.status_id": 4,
          "serialports.status_id": 4,
          "resource_id_string": "111301",
          "parallelports.status_id": 4,
          "infrared.status_id": 4,
          "printer.status_id": 4,
          "floppydisk.status_id": 4,
          "image.status_id": 4,
          "cdrom.status_id": 4,
          "managedcomputer.friendly_name": "John",
          "os_platform": 1,
          "agent_logged_on_users": "John",
          "diskdrive.status_id": 0,
          "mouse.status_id": 4,
          "resource_id": 111301,
          "tapedrive.status_id": 4,
          "resource_name": "John",
          "appledevices.status_id": 4,
          "keyboard.status_id": 4
        }
      ]
    },
    "message_version": "1.4",
    "status": "success"
  }
                
Show full