Retrieves all Temporarily Exempted Devices across 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 a list of devices granted temporary exemptions from device control policies. It supports filters for OS platform, exemption status, device type, time period, and domain, along with pagination.

Request URL

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

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

periodintegerOptional

Filter based on time period
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

statusintegerOptional

Filter temporary access permission records based on exemption status
0 - Yet to apply
1 - Awaiting schedule
2 - Active
3 - Expired

os_platformstringOptional

Filter based on OS Platform
1 - Windows
2 - Mac

devicetypelongOptional

Filter devices based on type
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 Network Adapters

domainstringOptional

Filter the records based on domain names

Sample Request

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

Show Sub-Attributes
JSON Object
Show Sub-Attributes
custom_device_namestring

Custom or friendly name of the device

cr.domain_netbios_namestring

Domain or workgroup the computer belongs to

ur.namestring

Name of the user or user group assigned to this policy

policy_idinteger

Unique identifier for the exemption policy

ta_typeinteger

Target assignment type

managedcomputer.friendly_namestring

Human-readable computer name

duration_typeinteger

Type of policy duration (1=Time-based, 2=Permanent)

duration_tolong

Timestamp when the policy expires

cr.namestring

Internal computer resource name

vendor_hex_idstring

Device vendor identifier in hexadecimal

os_platforminteger

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

allowed_devicesinteger

Maximum number of devices allowed under this policy

policy_namestring

Name of the exemption policy

is_agent_deployed_accessstring

Status of agent deployment for access control

device_typestring

Type of device (e.g., USB, removable storage)

serial_numberstring

Serial number of the device

applied_timelong

Timestamp when the policy was applied

duration_fromlong

Policy start timestamp

durationinteger

Policy duration in minutes

modified_timelong

Timestamp of last modification to the policy

product_hex_idstring

Product identifier in hexadecimal

parent_device_instance_idstring

Instance ID of the parent device, if applicable

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

Device exemption report response

Copied!
  {
    "response_code": 200,
    "message_type": "dcm",
    "message_response": {
      "total": 1,
      "limit": 25,
      "page": 1,
      "dcm": [
        {
          "custom_device_name": "--",
          "cr.domain_netbios_name": "WORKGROUP",
          "ur.name": "All Users Group",
          "policy_id": 14703,
          "ta_type": 1,
          "managedcomputer.friendly_name": "SYS-1",
          "duration_type": 1,
          "duration_to": 1755872590840,
          "cr.name": "uesqa-w10-1",
          "vendor_hex_id": "7812",
          "os_platform": 1,
          "allowed_devices": 0,
          "policy_name": "AccessName_2424",
          "is_agent_deployed_access": "smp.status.ytdeploy",
          "device_type": "smp.dcm.removablestoragedevice",
          "serial_number": "2425153",
          "applied_time": 0,
          "duration_from": 1755868990840,
          "duration": 60,
          "modified_time": 1755869002279,
          "product_hex_id": "7822",
          "parent_device_instance_id": "--"
        }
      ]
    },
    "message_version": "1.4",
    "status": "success"
  }
                
Show full