Retrieves the patch scan status report for all managed systems.
This API endpoint is deprecating soon
https://{serverurl}/dcapi/patch/reports/scan
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Number of records per page (default 25)
Page number to retrieve (1-based)
Column name to search within
Value to search for in the specified column
1: Windows, 2: Mac, 3: Linux (comma-separated)
Domain name filter
Branch office name filter
Custom group name filter
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, 2: Agent Down (comma-separated)
Computer name filter
Set True for mobile-optimized view returning Resource_ID
curl --request GET \
--url https://appdomains/dcapi/patch/reports/scan \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Pagination links for next and previous pages
URL for the next page of results, or null if on the last page
URL for the previous page of results, or null if on the first page
Array of scan status report entries
Date and time when the agent was installed
Directory path where the agent is installed
Current agent installation status
Version of the installed agent
Name of the computer
User-friendly display name of the device
Domain or workgroup the computer belongs to
System health status: Healthy, Vulnerable, Highly Vulnerable
IP address of the system
Language of the operating system
Last boot/restart time of the system
Last time the agent contacted the server
Last time the agent contacted the distribution server, or -- if not applicable
Date and time of the last patch scan
Status of the last scan: Scanning Completed, Scanning In Progress, Scan Failed, Not Scanned
Date and time of the last successful patch scan
Physical location of the system, or -- if not set
Currently or last logged-on user(s)
MAC address of the system
Admin notes for this system, or -- if none
Full operating system name and architecture
OS platform: Windows, Mac, Linux
Assigned owner of the device, or -- if not set
Email of the device owner, or -- if not set
Additional scan remarks or error details
Remote office the system belongs to
Search tag assigned to the system, or -- if none
Service pack level, or -- if not applicable
Pagination metadata
Operation result: success
Total number of pages available
Total number of records matching the query
Error code: INTERNAL_ERROR for server-side failures
Localized error description: dc.rest.api_internal_error
Scan status report data
{
"metadata": {
"limit": 25,
"page": 1
},
"totalRecords": 1,
"messageResponse": [
{
"OperatingSystem": "Red Hat Enterprise Linux 8 (x86_64)",
"LastScanStatus": "Scanning Completed",
"Owner": "--",
"AgentVersion": "10.0.337.L",
"LastContactedTimeWithDs": "--",
"RemoteOffice": "localOfficeOne",
"LastBootTime": "Dec 14, 2015 10:44 AM",
"LastScan": "Mar 3, 2025 06:26 PM",
"AgentStatus": "Installed Successfully",
"Language": "Multilingual",
"Remarks": "Scanning completed successfully",
"LastContactTime": "Mar 3, 2025 06:26 PM",
"AgentInstalledDate": "Mar 3, 2025 06:26 PM",
"AgentInstalledDirectory": "C:\\Program Files (x86)\\DesktopCentral_Agent\\",
"SearchTag": "--",
"Notes": "--",
"OwnerEmail": "--",
"DeviceFriendlyName": "LinuxMachine16",
"Health": "Highly Vulnerable",
"OsPlatform": "Linux",
"LastSuccessfulScan": "Mar 3, 2025 06:26 PM",
"MacAddress": "d6:57:b1:a0:54",
"LoggedOnUsers": "Browser Security Manager",
"ComputerName": "LinuxMachine16",
"ServicePack": "--",
"IpAddress": "153.97.180.148",
"Domain": "linuxosgroup",
"Location": "--"
}
],
"totalPages": 1,
"Links": {
"next": null,
"prev": null
},
"status": "success"
}
Server-side error
{
"error_description": "dc.rest.api_internal_error",
"error_code": "INTERNAL_ERROR"
}
![]()
Duration: 1 minute | Threshold: 50 | 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.