Returns every application group (whitelist, blacklist) along with metadata such as rule count, associated custom groups, and timestamps.
https://{server-hostname}:8383/dcapi/appctrl/appgroups
AppControl.READCopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
curl --request GET \
--url https://appdomain/dcapi/appctrl/appgroups \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Unique identifier for the application group
Name of the application group
Type of application group (1=Whitelist, 2=Blacklist, 3=Privilege)
Platform ID (1=Windows, 2=Mac)
Category (1=User Defined, 2=System)
Total count of application rules in the group
Count of custom groups associated with this app group
Description of the application group
Creation timestamp in milliseconds since epoch
Last modification timestamp in milliseconds since epoch
Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
Authentication failure reason
Internal error code: INTERNAL_ERROR when exception occurs fetching app groups
Detailed message: Exception Occurred While getting AppGroups
List of application groups
[
{
"modifiedTime": 1700100000000,
"associatedCustomGroupCount": 3,
"appGroupName": "Whitelist Group 1",
"appGroupType": 1,
"groupID": 101,
"description": "Default whitelist group",
"createdTime": 1700000000000,
"appGroupCategory": 1,
"platformID": 1,
"applicationRuleCount": 25
}
]
Authentication credentials missing or invalid
{
"errorMessage": "Authentication credentials are missing or invalid",
"errorCode": "UNAUTHORIZED"
}
Internal error while fetching application groups
{
"errorMessage": "Exception Occurred While getting AppGroups",
"errorCode": "INTERNAL_ERROR"
}
![]()
Duration: 1 minute | Threshold: 120 | 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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.