# Retrieve All Managed Systems with Patch Information Retrieves all managed systems with their patch information. **This API endpoint is deprecating soon** ## Endpoint `GET /dcapi/patch/reports/allSystems` ## Request ### Request URL `https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/patch/reports/allSystems` ### Scope `DesktopCentralCloud.PatchMgmt.READ` ### Header `Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52` ### Request Parameters #### Query Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `pageLimit` | integer | Optional | Number of records per page (default 25) | | `page` | integer | Optional | Page number to retrieve (1-based) | | `searchColumn` | string | Optional | Column name to search within | | `searchValue` | string | Optional | Value to search for in the specified column | | `branchOffice` | string | Optional | Branch office name filter | | `platform` | long | Optional | 1: Windows, 2: Mac, 3: Linux | | `resourceLiveStatus` | long | Optional | 1: Agent Live, 2: Agent Down | | `healthStatus` | long | Optional | 0: Unknown, 1: Healthy, 2: Vulnerable, 3: Highly Vulnerable | | `resourceId` | long | Optional | Specific resource ID filter | | `domain` | string | Optional | Domain name filter | | `customGroupFilter` | string | Optional | Get Custom Group list from api/1.4/desktop/serverproperties | | `isWebView` | string | Optional | Whether request is from web view | | `skipColumns` | string | Optional | Comma-separated column names to exclude from response | ### Sample Request ```curl curl --request GET \ --url https://appdomains/dcapi/patch/reports/allSystems \ --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' ``` ## Response Parameters ### HTTP Code 200 Response body: `application/json` | Parameter | Type | Description | |---|---|---| | `Links` | JSON Object | Pagination links for next and previous pages | | `messageResponse` | JSON Array | Array of system entries | | `metadata` | JSON Object | Pagination metadata | | `status` | string | Operation result: success | | `totalPages` | string | Total number of pages available | | `totalRecords` | string | Total number of records matching the query | #### Links | Parameter | Type | Description | |---|---|---| | `next` | string | URL for the next page of results, or null if on the last page | | `prev` | string | URL for the previous page of results, or null if on the first page | ### HTTP Code 500 Response body: `application/json` | Parameter | Type | Description | |---|---|---| | `error_code` | string | Error code: INTERNAL_ERROR for server-side failures | | `error_description` | string | Localized error description: dc.rest.api_internal_error | ### Sample Response: HTTP 200 All systems with patch data ```json { "metadata": { "limit": 25, "page": 1 }, "totalRecords": "1", "messageResponse": [ { "resource_name_transform": "WinMachine13", "missing_bios_patches": "0", "oslanguage_languageid": "0", "resource_health_status": "1", "critical_patch_count_transform": "--", "os_language": "0", "low_patch_count_transform": "--", "last_patched_time": "-1", "total_driver_patches_transform": "0", "total_patches_column_transform": "--", "installed_tp_patches": "9", "resourcedeploymentstatus_resource_id": "16222000000270139", "service_pack": "Windows 7 SP1 (x64)", "os_name_transform": "Windows 11 Enterprise for Virtual Desktops (x64)", "os_language_abbr": "co", "deployment_status_transform": "--", "domain_netbios_name_transform": "ZOHOCORP", "location_transform": "--", "branch_office_name_transform": "Default Remote Office", "scan_remarks": "dc.patch.util.Scanning_completedsuccessfully", "agent_last_ds_contact_time": "-1", "os_platform": "1", "agent_logged_on_users": "Browser Security Manager", "missing_driver_patches": "0", "i18n": "Multilingual", "search_tag": null, "missing_ms_patches": "0", "pmresourcepatchcount_resource_id": "16222000000270139", "low_patch_count": "0", "last_scan_time_transform": "Mar 3, 2025 06:21 PM", "friendly_name_transform": "WinMachine13", "last_successful_scan": "1741006279892", "processor_architecture": "0", "agent_last_contact_time": "1741006238768", "resourcetorebootdetails_resource_id": null, "installed_bios_patches": "0", "owner_email_id_transform": "--", "domain_netbios_name": "ZOHOCORP", "fqdn_name": "WINMACHINE4.CSEZ.ZOHOCORPIN.COM", "last_patched_time_transform": "--", "last_operation_transform": "--", "reboot_req_status": null, "agent_last_ds_contact_time_transform": "--", "moderate_patch_count": "0", "description_transform": "--", "timezone_offset": "-480", "agent_logged_on_users_transform": "Application Control Manager", "mac_address_transform": "d4:67:b7:a0:13", "resource_health_status_transform": "Not scanned", "agent_last_bootup_time": "1450070085000", "missing_tp_patches_transform": "0", "os_name": "Windows 7 Professional Edition (x64)", "resource_id": "16222000000270139", "computer_live_status": "3", "customer_name": "ems-testingautomation+get_patch46", "customer_id": "16222000000226138", "resource_name": "WinMachine4", "status_image": "", "total_driver_patches": "0", "installed_driver_patches_transform": "0", "installed_ms_patches_transform": "0", "branch_office_id": "16222000000238916", "os_platform_name": "Windows", "installed_tp_patches_transform": "0", "total_tp_patches_transform": "0", "installed_ms_patches": "2", "owner_transform": "--", "important_patch_count": "0", "os_platform_name_transform": "Windows", "pmreshealthstatus_resource_id": "16222000000270139", "installed_bios_patches_transform": "0", "timezone_offset_transform": "GMT-8:0", "total_ms_patches_transform": "0", "total_bios_patches_transform": "0", "agent_last_contact_time_transform": "Mar 3, 2025 06:20 PM", "i18n_transform": "Spanish", "missing_bios_patches_transform": "0", "moderate_patch_count_transform": "--", "osflavor_id": "0", "total_ms_patches": "2", "status_label": "", "owner_email_id": null, "last_action_initiated_on": null, "missing_tp_patches": "0", "branchmemberresourcerel_resource_id": "16222000000270139", "computer_status_update_time": "1741006239168", "customerinfo_customer_id": "16222000000226138", "branch_office_name": "Default Remote Office", "missing_ms_patches_transform": "0", "total_tp_patches": "9", "description": null, "critical_patch_count": "0", "total_bios_patches": "0", "installed_driver_patches": "0", "ip_address_transform": "149.68.109.72", "search_tag_transform": "--", "agent_last_bootup_time_transform": "Dec 14, 2015 10:44 AM", "mac_address": "d5:63:b0:a2:62", "shutdown_status_update_time": null, "owner": null, "missing_driver_patches_transform": "0", "friendly_name": "WinMachine4", "scan_status": "228", "last_successful_scan_transform": "--", "last_sync_time": null, "deployment_status": "208", "resource_resource_id": "16222000000270139", "ip_address": "252.148.93.191", "service_pack_transform": "Windows 11 Version 21H2 (x64)", "patchmgmtosinfo_resource_id": "16222000000270139", "shutdown_status": null, "total_patches_column": "11", "location": null, "last_scan_time": "1741006279892", "important_patch_count_transform": "--", "last_operation": null, "remarks": null } ], "totalPages": 1, "Links": { "next": null, "prev": null }, "status": "success" } ``` ### Sample Response: HTTP 500 Server-side error ```json { "error_description": "dc.rest.api_internal_error", "error_code": "INTERNAL_ERROR" } ``` ## Rate Limit ![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png) **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.