Retrieves the list of all systems along with their patch scan status.
This API endpoint is deprecating soon
get /api/1.4/patch/scandetails
https://{serverurl}/api/1.4/patch/scandetails
DesktopCentralCloud.PatchMgmt.READCopied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Filter for system with a resource id
Get domain list from api/1.4/desktop/serverproperties
Windows/Mac/Linux
Get branch office list from api/1.4/desktop/serverproperties
Get Custom Group list from api/1.4/desktop/serverproperties
0: Unknown — patch status is not available, 1: Healthy — system is up-to-date, 2: Vulnerable — system has missing patches, 3: Highly Vulnerable — system has critical or high-risk missing patches
1: Agent Live (agent is running), 2: Agent Down (agent is not responding)
Number of records per page.
Current page number for pagination.
21: Not Installed (agent is not installed), 22: Installed (agent is installed)
curl --request GET \
--url https://appdomain/api/1.4/patch/scandetails \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Value: scandetails
Paginated scan details data
Total number of systems with scan data
Array of system scan detail objects
Computer name of the system
Unique resource identifier
Domain name of the system
Branch or remote office name
Branch office identifier
Scan status: 226=Failed, 227=InProgress, 228=Success, 229=NotScanned
Live status: 1=Live, 2=Down
Health: 0=Unknown, 1=Healthy, 2=Vulnerable, 3=Highly Vulnerable
Installation status code
Platform ID: 1=Windows, 2=Mac, 3=Linux
Platform name
Full operating system name
Service pack or OS version
Agent version installed
Timestamp of last scan attempt
Timestamp of last successful scan
IP address(es) of the system
MAC address(es) of the system
Scan result remarks
Records per page
Current page number
API version: 1.0
Operation status: success
Response code: 200
Paginated list of systems with scan status
{
"response_code": 200,
"message_type": "scandetails",
"message_response": {
"total": 94,
"limit": 25,
"page": 1,
"scandetails": [
{
"branch_office_name": "Local Office",
"scan_status": 228,
"resource.name": "WIN-SERVER-01",
"resource_health_status": 3,
"scan_remarks": "dc.patch.util.Scanning_completedsuccessfully",
"os_platform": 1,
"ip_address": "192.168.1.100",
"branch_office_id": 1,
"os_platform_name": "Windows",
"agent_version": "10.0.267.W",
"mac_address": "00:0c:29:7e:51:a7",
"resource.domain_netbios_name": "WORKGROUP",
"service_pack": "Windows 10 Version 1803 (x64)",
"resource_id": 47707,
"installation_status": 22,
"os_name": "Windows 10 Professional Edition (x64)",
"computer_live_status": 1,
"last_scan_time": 1552904526258,
"last_successful_scan": 1552904526258
}
]
},
"message_version": "1.0",
"status": "success"
}
![]()
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.