This API lists all file shadow operations performed on network-connected devices. It supports filters based on status, time period, domain, computer, group, and recent activity.
get /api/1.4/reports/dcm/fileshadow
https://{serverurl}/api/1.4/reports/dcm/fileshadow
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Current page number for pagination
Number of records per page
Filter devices connected to a group of computers based on its group ID. Group IDs can be obtained from /api/1.4/customgroup/getCGList
Filter file activities that occurred in the last N days
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
Start timestamp for date range filter
End timestamp for date range filter
Filter records based on file shadow status
1 - Yet to start
2 - Excluded
3 - Wait
4 - Ready
5 - In progress
6 - Success
7 - Failed
8 - Cancelled
Filter the records based on domain names
Filter devices connected to a particular computer. Resource IDs can be obtained from /api/1.0/som/computers
Filter by user resource ID
curl --request GET \
--url https://appdomains/api/1.4/reports/dcm/fileshadow \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Module code identifier
Response data container
Total number of records
Maximum number of records in this response
Current page number
Array of file shadow records
Name of the shadowed file
File extension indicating type
File size in bytes
Original location of the file on the system
Shadow copy storage path
Unique device serial number
Detected device name
Hexadecimal identifier of the device vendor
Hexadecimal identifier of the product model
Custom or user-defined device name
User-friendly display name of the computer
Actual computer hostname
Domain or Workgroup the computer belongs to
Logged-in user account name
Timestamp when the device was connected
Timestamp of the file's last modification
Final status of shadowing process (success/failure)
Additional remarks or status messages
API version
Status of API call (success/failure)
HTTP response code
File shadow report response
{
"response_code": 200,
"message_type": "dcm",
"message_response": {
"total": 1,
"limit": 25,
"page": 1,
"dcm": [
{
"custom_device_name": "--",
"extension": "xml",
"last_modified_time": 1756101935079,
"computerresource.domain_netbios_name": "WORKGROUP",
"file_name": "metadata.xml",
"managedcomputer.friendly_name": "John",
"vendor_hex_id": "0781",
"serial_number": "04015160df329088ed07728df07b1a1c737c3aff5aab42687e3a3fafcf59e155b5871111000000000000000026af6cefff9d8118ab5581077e2d235c",
"remote_shadow_path": "\\\\SYSTEM-1\\SYS\\2025-08-25\\WORKGROUP\\John\\John\\2025-08-25--06-05-06-257 - USB SanDisk 3.2Gen1 USB Device\\New folder\\metadata.xml",
"userresource.name": "John",
"connected_time": 1756101906257,
"device_name": " USB SanDisk 3.2Gen1 USB Device",
"source_file_path": "E:\\New folder\\metadata.xml",
"product_hex_id": "55ab",
"finalstatus.overall_status": "dc.common.SUCCESS",
"file_shadow_remarks": "smp.agent.fs.SUCCESS",
"file_length": 2345,
"computerresource.name": "John"
}
]
},
"message_version": "1.4",
"status": "success"
}
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.