Retrieves all systems managed by Endpoint Central along with their patch health and scan.
This API endpoint is deprecating soon
View new endpoint >https://{serverurl}/api/1.4/patch/allsystems Copied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Unique ID of the system (resource) to filter by. Get the resource ID from Get All Systems api
Returns only the systems that belong to the given domain. Provide the domain name. Get the domain names from Get Domains api
Returns only the records of the given operating system platform. Accepted values: windows, mac, linux.
Returns only the systems that belong to the given remote office. Provide the remote office name. Get the remote office names from Get Remote Offices api
Returns only the systems that are members of the given custom group. Provide the custom group name. Get the custom group names from Get Custom Groups api
Returns only the systems with the given patch health status. Accepted values: 0 - Not Available, 1 - Healthy, 2 - Vulnerable, 3 - Highly Vulnerable.
Returns only the systems with the given agent live status. Accepted values: 1 - Live, 2 - Down, 3 - Unknown.
Text to look up in the column given in searchcolumn. Use together with searchtype and searchcolumn.
Name of the column (field) in the response in which the search text is looked up. Use together with searchtype and searchvalue.
Type of search to be performed on the column, for example, contains. Search is applied only when searchtype, searchcolumn and searchvalue are all provided.
Direction in which the records are sorted. Allowed values: ASC (ascending) and DESC (descending). Use together with orderby.
Name of the column (field) in the response by which the records are sorted. Use together with sortorder.
Number of records to be returned per page. Minimum 1, maximum 1000. Default is 25.
Page number of the result set to be returned. Minimum 1, maximum 100000. Default is 1.
curl --request GET \
--url https://appdomains/api/1.4/patch/allsystems \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Value: allsystems
Paginated systems data with patch health and scan status
Array of system objects with patch and scan details
Last boot time in epoch milliseconds
Formatted last boot time
Last contact time in epoch milliseconds
Formatted last contact time
Last DS contact time in epoch, or -1
Formatted last DS contact time, or --
Currently logged on users
Transformed logged on users
Branch office identifier
Branch office name
Transformed branch office name
Branch member resource relation ID
Computer live status code
Status update time in epoch
Number of critical missing patches
Transformed critical patch count, or --
Customer identifier
Customer name
Customer info customer ID
Deployment status code
Transformed deployment status, or --
System description, or null
Transformed description, or --
Domain NetBIOS name
Transformed domain name
Fully qualified domain name
Friendly name of the computer
Transformed friendly name
Internationalization/language setting
Transformed language display
Number of important missing patches
Transformed important patch count, or --
Count of installed BIOS patches
Transformed installed BIOS patches count
Count of installed driver patches
Transformed installed driver patches count
Count of installed Microsoft patches
Transformed installed MS patches count
Count of installed third-party patches
Transformed installed TP patches count
IP address of the system
Transformed IP address
Last action initiated time, or null
Last operation performed, or null
Transformed last operation, or --
Last patched time in epoch, or -1
Formatted last patched time, or --
Last scan time in epoch milliseconds
Formatted last scan time
Last successful scan time in epoch
Formatted last successful scan, or --
Last sync time, or null
Location, or null
Transformed location, or --
Number of low-severity missing patches
Transformed low patch count, or --
MAC address
Transformed MAC address
Count of missing BIOS patches
Transformed missing BIOS patches count
Count of missing driver patches
Transformed missing driver patches count
Count of missing Microsoft patches
Transformed missing MS patches count
Count of missing third-party patches
Transformed missing TP patches count
Number of moderate-severity missing patches
Transformed moderate patch count, or --
OS language code
OS language abbreviation
Operating system name
Transformed OS name
OS platform code: 1=Windows, 2=Mac, 3=Linux
OS platform display name
Transformed platform name
OS flavor identifier
OS language identifier
System owner, or null
Owner email, or null
Transformed owner email, or --
Transformed owner, or --
Patch mgmt OS info resource ID
PM resource health status resource ID
PM resource patch count resource ID
Processor architecture code
Reboot required status, or null
Remarks, or null
Resource health status code
Transformed health status display
Resource identifier
Resource name
Transformed resource name
Resource-resource ID
Deployment status resource ID
Reboot details resource ID, or null
Scan remarks message key
Scan status code
Search tag, or null
Transformed search tag, or --
Service pack or OS version
Transformed service pack
Shutdown status, or null
Shutdown status update time, or null
Status image path
Status label
Timezone offset in minutes
Formatted timezone offset
Total BIOS patches count
Transformed total BIOS patches
Total driver patches count
Transformed total driver patches
Total Microsoft patches count
Transformed total MS patches
Total patches column value
Transformed total patches, or --
Total third-party patches count
Transformed total TP patches
Total number of managed systems
Number of records per page
Current page number
API version: 1.0
Operation status: success
Response code: 200
Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
Authentication failure reason
Forbidden error code returned when the authenticated user does not have the required uem-roles (e.g., DataEncryption_Admin or DataEncryptionRecoveryKey_Admin)
Message indicating insufficient privileges to access this resource
Rate limit error code returned when the API call threshold (configured via threshold/duration in security XML) is exceeded; client is locked out for lock-period minutes
Rate limit exceeded message with retry guidance
{
"message_type": "allsystems",
"message_response": {
"allsystems": [
{
"resource_health_status": 3,
"os_language": 1,
"branchmemberresourcerel.resource_id": 301,
"branch_office_id": 1,
"last_patched_time": 1553069752000,
"os_platform_name": "Windows",
"pmreshealthstatus.resource_id": 301,
"installed_tp_patches": 9,
"installed_ms_patches": 12,
"important_patch_count": 2,
"service_pack": "Windows 10 Version 1809 (x64)",
"resourcetorebootdetails.resource_id": "--",
"pmresourcepatchcount.resource_id": 301,
"resourcetorebootdetails.reboot_req_status": "--",
"os_language_abbr": "en",
"resourcedeploymentstatus.resource_id": 301,
"scan_remarks": "dc.patch.util.Scanning_completedsuccessfully",
"os_platform": 1,
"agent_logged_on_users": "XXXX-1234",
"total_ms_patches": 14,
"osflavor_id": 0,
"search_tag": "--",
"status_label": "dc.db.config.status.failed",
"owner_email_id": "--",
"missing_ms_patches": 2,
"last_action_initiated_on": "--",
"missing_tp_patches": 3,
"low_patch_count": 0,
"patchmgmtosinfo.resource_id": 301,
"last_successful_scan": 1553073465582,
"computer_status_update_time": 1553063563662,
"branch_office_name": "Local Office",
"agent_last_contact_time": 1553069591000,
"total_tp_patches": 12,
"description": "--",
"critical_patch_count": 2,
"domain_netbios_name": "ZOHOCORP",
"mac_address": "1a:aa:1a:1a:11:1a",
"resource.resource_id": 301,
"shutdown_status_update_time": "--",
"moderate_patch_count": 1,
"owner": "--",
"scan_status": 228,
"timezone_offset": "330",
"oslanguage.languageid": 1,
"last_sync_time": 1553074057839,
"deployment_status": 206,
"oslanguage.i18n": "dc.patch.patchinfo.English",
"ip_address": "XXX.XXX.XXX.XXX",
"shutdown_status": "--",
"agent_last_bootup_time": 1552885231000,
"resource_id": 301,
"os_name": "Windows 10 Professional Edition (x64)",
"location": "--",
"computer_live_status": 1,
"resource_name": "XXXX-YYYY",
"last_scan_time": 1553073465582,
"remarks": "--",
"last_operation": "--",
"status_image": "/images/failureicon.gif"
}
],
"total": 26,
"limit": 25,
"page": 2
},
"message_version": "1.0",
"status": "success",
"response_code": 200
}
Authentication credentials are missing, expired or invalid
{
"error_code": "UAC_UNAUTHORIZED",
"error_description": "dc.rest.authentication.unauthorized"
}
Authenticated user lacks the required role or scope
{
"errorCode": "FORBIDDEN",
"errorMessage": "You do not have sufficient privileges to perform this operation"
}
API call threshold exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMessage": "API call limit exceeded. Retry after the lock period elapses"
}
![]()
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.