Retrieves a comprehensive list of all patches applicable to systems, with extensive filter support for targeted querying.
https://{serverurl}/dcapi/threats/patches Copied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Page number of the result set to be returned. Minimum 1, maximum 1000.
Returns only the patches that fix the given CVE ID. Example: CVE-2024-21412.
Returns only the patches with the given reboot requirement. Accepted values: required, not required, autoreboot, may require.
Returns only the patches released by the given vendor. Example: Microsoft. Get the vendor name from Get Supported Patches api.
Returns only the patches of the given update type. (Applicable inputs: Security Updates, Non-Security Updates, Third-Party Updates, Definition Update, Service Packs, Feature Packs, Rollups, Tools, Driver, Optional Updates, Preview Rollups and BIOS)
Returns only the patches of the given severity. Accepted values: Unrated, Low, Moderate, Important, Critical.
Returns only the patches of the given operating system platform. Accepted values: Windows, Mac, Linux.
Returns only the patches released at the given time. Provide the release time as epoch milliseconds. Multiple values can be given as a comma-separated list.
Returns only the patches with the given status on the systems. Accepted values: Missing, Failed, Installed.
Returns only the patches whose description contains the given text. Example: Security Update for Windows.
Returns only the patches whose name contains the given text. Example: KB5034441. Get patch names from Get Supported Patches api.
Returns only the patches that belong to the given security bulletin. Provide the bulletin ID published by the vendor, for example, MS15-041 or TU-636. Get the bulletin ID from Get Supported Patches api.
Filters patches based on the patch ID provided. Fetch from Get Supported Patches
Filters patches based on the patch uninstallation support (as specified by the vendor).
Filters patches based on the approved time.
Filters patches based on the provided KB number.
ID of the patch that supersedes this patch
Filters patches based on the provided patch support date.
Filters patches based on the provided size.
Filters patches based on the post-deployment reboot option configured. (Applicable inputs: required, not required, autoreboot, may require)
Filters patches based on the download status provided.
Number of systems on which the patch is installed
Number of systems on which the patch is missing
Number of systems on which the patch installation failed
Number of patches to be returned per page. Minimum 1, maximum 1000.
curl --request GET \
--url https://appdomains/dcapi/threats/patches \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Contains the patches array
Array of patch objects with threat data
First name of the user who approved the patch
Security bulletin identifier (e.g., MS15-041)
Current download status of the patch, or -- if not downloaded
Number of systems where installation failed
Number of systems where this patch is installed
Knowledge base article number
Number of systems where this patch is missing
Full description of the patch
Patch release timestamp in milliseconds since epoch
Patch file size in bytes
Approval status: approved, unapproved, declined
Timestamp when the patch was added to the supported list
Uninstall support: supported, not supported
Unique patch identifier
Patch file name
Target platform: Windows, Mac, Linux
Reboot requirement: required, not required, autoreboot, may require
Patch severity: Critical, Important, Moderate, Low, Unrated
Patch ID that supersedes this patch, or NA if none
Patch type: Security Updates, Non-Security Updates, Third-Party Updates, Definition Update, Service Packs, Feature Packs, Rollups, Tools, Driver, Optional Updates, Preview Rollups, BIOS
Last updated timestamp in milliseconds since epoch
Vendor name (e.g., Microsoft)
Response type identifier: patches
Pagination metadata including page info and navigation links
Number of records per page
Total number of matching records as a string
Total number of pages available
Pagination navigation links
URL for the next page, or null if on the last page
URL for the previous page, or null if on the first page
Current page number
Response code: 200 for success
Operation result: success
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
{
"metadata": {
"pageLimit": 30,
"totalRecords": "2",
"totalPages": 1,
"links": {
"next": null,
"prev": null
},
"page": 1
},
"response_code": 200,
"message_type": "patches",
"message_response": {
"patches": [
{
"severity": "Important",
"patchname": "vcredist_x86_sp1.exe",
"updated_time": "1704363395117",
"update_type": "Security Updates",
"patch_description": "Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package MFC Security Update",
"kb_number": "2565063",
"vendor_name": "Microsoft",
"installed_system_count": 1,
"supercededby": "NA",
"patch_released_time": "1307989800000",
"patch_supported_time": "1307989800000",
"patch_size": "8993744",
"patchid": "12621",
"patch_uninstall": "not supported",
"bulletinid": "MS11-025",
"approveduser_first_name": "DC-SYSTEM-USER",
"reboot_required": "may require",
"platform_name": "Windows",
"download_status": "--",
"missing_system_count": 0,
"failed_system_count": 0,
"patch_status": "approved"
},
{
"severity": "Important",
"patchname": "vcredist_x64_sp1.exe",
"updated_time": "1704363395117",
"update_type": "Security Updates",
"patch_description": "Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package MFC Security Update",
"kb_number": "2565063",
"vendor_name": "Microsoft",
"installed_system_count": 1,
"supercededby": "NA",
"patch_released_time": "1307989800000",
"patch_supported_time": "1307989800000",
"patch_size": "10274136",
"patchid": "12622",
"patch_uninstall": "not supported",
"bulletinid": "MS11-025",
"approveduser_first_name": "DC-SYSTEM-USER",
"reboot_required": "may require",
"platform_name": "Windows",
"download_status": "--",
"missing_system_count": 0,
"failed_system_count": 0,
"patch_status": "approved"
}
]
},
"status": "success"
}
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.