# Retrieve Missing Patches Across Managed Systems Retrieves a paginated list of patches that are missing (not installed) across managed systems, including severity, download status, and affected system counts. **This API endpoint is deprecating soon** [View new endpoint](https://www.manageengine.com/products/desktop-central/help/api/cloud/patch-report-get-missing-patches-report.html) ## Endpoint `GET /api/1.4/patch/missingpatches` ## Request ### Request URL https://[*{serverurl}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/api/1.4/patch/missingpatches ### Scope `DesktopCentralCloud.PatchMgmt.READ` ### Header `Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52` ### Request Parameters #### Request Headers | Parameter | Type | Required | Value | Description | |---|---|---|---|---| | Accept | string | Mandatory | `application/json` | | #### Query Parameters | Parameter | Type | Required | Description | |---|---|---|---| | loginid | string | Optional | | | resource_id | string | Optional | `{resource_id}` - Unique identifier of the computer | | userid | string | Optional | | | username | string | Optional | | | ticket | string | Optional | | | customerid | string | Optional | | | customerName | string | Optional | | | customername | string | Optional | | | residfilter | integer | Optional | Filter computer with particular resource id | | domainfilter | string | Optional | Get domain list from api/1.4/desktop/serverproperties | | branchofficefilter | string | Optional | Get branch office list from api/1.4/desktop/serverproperties | | remoteofficefilter | string | Optional | | | customgroupfilter | string | Optional | Get custom group list from api/1.4/desktop/serverproperties | | livestatusfilter | integer | Optional | 1 - Live: System is working.
2 - Down: System is not working.
3 - Unknown: System status is not known. | | platformfilter | string | Optional | | | connidfilter | string | Optional | | | page | string | Optional | | | pagelimit | string | Optional | | | orderby | string | Optional | | | sortorder | string | Optional | | | sortcolumn | string | Optional | | | searchtype | string | Optional | | | searchcolumn | string | Optional | | | searchvalue | string | Optional | | | patchid | string | Optional | | | resid | string | Optional | `{resid}` - Unique identifier of the computer | | languagefilter | integer | Optional | | | approvalstatusfilter | integer | Optional | | | downloadstatusfilter | integer | Optional | | | supercedestatusfilter | integer | Optional | | | healthfilter | integer | Optional | | | severityfilter | integer | Optional | | | patchtypefilter | integer | Optional | | | patchstatusfilter | integer | Optional | | | agentinstallationstatusfilter | integer | Optional | | | installstatusfilter | integer | Optional | 21: Yet to install (agent has not been installed).
22: Installed (agent is currently installed).
23: Uninstalled (agent has been removed).
24: Yet to uninstall (marked for uninstallation but not yet removed).
29: Installation failure (an error occurred during installation). | | licensetypefilter | integer | Optional | 1: Commercial (used for business or paid purposes).
2: Non-commercial (used for personal or educational purposes).
0: Unidentified (license type not specified). | | scanstatusfilter | integer | Optional | -1: Not done scan has not started.
0: Failed scan failed.
1: In progress scan is ongoing.
2: Success scan completed successfully. | | deploymentstatusfilter | integer | Optional | | | configtypefilter | integer | Optional | | | accesstypefilter | integer | Optional | 1: Allowed (access is permitted).
2: Prohibited (access is restricted).
0: Not assigned (no access configuration). | | compliancestatusfilter | integer | Optional | 0: Under licensed (fewer licenses than required).
1: Over licensed (more licenses than needed).
2: In compliance (license usage matches availability).
3: Expired (license validity has ended).
-1: Not available (compliance data is missing). | | complianceStatusFilter | integer | Optional | | | bulletinid | string | Optional | | | oscompatibilityfilter | string | Optional | 32-bit: For 32-bit operating systems.
64-bit: For 64-bit operating systems. | | uninstallsupportfilter | string | Optional | Yes: Supports uninstallation.
No: Does not support uninstallation. | | installerformatfilter | string | Optional | MSI: Installed via MSI installer.
EXE: Installed via EXE installer. | | licensefilter | string | Optional | Get License List from api/1.4/inventory/licenses?swid={softwareID} in license_id parameter inside message response | | hardwaretypefilter | string | Optional | Get hardware type list from api/1.4/inventory/filterparams | | manufacturerfilter | string | Optional | Get hardware manufacturer list from api/1.4/inventory/filterparams | | osfilter | string | Optional | | | vendorfilter | string | Optional | | | policyname | string | Optional | | | configstatusfilter | string | Optional | | | viewtypefilter | string | Optional | | | latestpatches | string | Optional | | | prohibitedswid | string | Optional | Unique identifier of the prohibited software | | categoryfilter | string | Optional | | | ticketid | string | Optional | | ### Sample Request ```bash curl --request GET \ --url https://appdomains/api/1.4/patch/missingpatches \ --header 'Accept: application/json' \ --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' ``` ## Response Parameters ### HTTP Code 200 Response Body: `application/json` | Attribute | Type | Description | |---|---|---| | message_type | string | Value: missingpatches | | message_response | JSON Object | Paginated missing patches data | | message_version | string | API version: 1.0 | | status | string | Operation status: success | | response_code | string | Response code: 200 | ### Sample Response: HTTP 200 Paginated missing patches ```json { "message_type": "missingpatches", "message_response": { "total": 26, "missingpatches": [ { "patch_id": 309232, "bulletin_id": "TU-058", "patch_name": "FileZilla_3.41.2_win32-setup.exe", "patch_description": "FileZilla Client (3.41.2)", "severity": 1, "missing": 5, "failed": 2, "platform_name": "Windows", "update_name": "Third Party Updates", "patch_released_time": 1552971857000, "patch_noreboot": 1, "patch_uninstall_status": 1, "patch_size": 7917152, "vendor_name": "Tim Kosse", "superceded_by": "NA" } ], "limit": 25, "page": 2 }, "message_version": "1.0", "status": "success", "response_code": 200 } ``` ### HTTP Code 401 Response Body: `application/json` | Attribute | Type | Description | |---|---|---| | errorCode | long | Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required) | | errorMsg | string | Authentication failure reason | ### Sample Response: HTTP 401 Authentication credentials are missing, expired or invalid ```json { "error_code": "UAC_UNAUTHORIZED", "error_description": "dc.rest.authentication.unauthorized" } ``` ### HTTP Code 403 Response Body: `application/json` | Attribute | Type | Description | |---|---|---| | errorCode | long | Forbidden error code returned when the authenticated user does not have the required uem-roles (e.g., DataEncryption_Admin or DataEncryptionRecoveryKey_Admin) | | errorMsg | string | Message indicating insufficient privileges to access this resource | ### Sample Response: HTTP 403 Authenticated user lacks the required role or scope ```json { "errorCode": "FORBIDDEN", "errorMessage": "You do not have sufficient privileges to perform this operation" } ``` ### HTTP Code 429 Response Body: `application/json` | Attribute | Type | Description | |---|---|---| | errorCode | long | 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 | | errorMsg | string | Rate limit exceeded message with retry guidance | ### Sample Response: HTTP 429 API call threshold exceeded ```json { "errorCode": "RATE_LIMIT_EXCEEDED", "errorMessage": "API call limit exceeded. Retry after the lock period elapses" } ``` ## Rate Limits ![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png) **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.