Retrieves a specific webdomain group and its associated webdomains.
https://{server-hostname}:8383/bsp/api/v1/bmp/webdomain-groups/{webdomain_group_id}
BrowserManager.READCopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Web domain group ID from List WebDomain Groups or Create WebDomain Group response
curl --request GET \
--url https://appdomain/bsp/api/v1/bmp/webdomain-groups/{webdomain_group_id} \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Unique identifier for the webdomain group
Display name of the webdomain group. Maximum 50 characters
Description of the webdomain group. Maximum 100 characters
Username of the user who originally created this group
Group creation timestamp in milliseconds since epoch
Username of the user who last modified this group
Last modification timestamp in milliseconds since epoch
Webdomains associated with this group. Empty for newly created groups
Unique identifier for the webdomain
Webdomain display name
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
Message indicating the specified webdomain group was not found
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 describing the internal server error
Error code identifying the type of server error
Group with webdomains
{
"created_time": 1741651200000,
"last_modified_time": 1741651200000,
"webdomain_group_id": 100,
"webdomain_group_name": "Social Media Sites",
"description": "Group containing social media webdomains",
"last_modified_by": "admin",
"available_webdomains": [
{
"webdomain_name": "*.facebook.com",
"webdomain_id": 107
},
{
"webdomain_name": "https://twitter.com:443/home?lang=en",
"webdomain_id": 108
}
],
"created_by": "admin"
}
Group with no webdomains
{
"created_time": 1741651200000,
"last_modified_time": 1741651200000,
"webdomain_group_id": 101,
"webdomain_group_name": "Empty Group",
"description": "A group with no webdomains yet",
"last_modified_by": "admin",
"available_webdomains": [],
"created_by": "admin"
}
Unauthorized
{
"errorCode": "UNAUTHORIZED",
"errorMsg": "You are not authorized to perform this action"
}
Insufficient permissions
{
"errorCode": "FORBIDDEN",
"errorMsg": "You do not have permission to access this resource"
}
Group not found
{
"error_description": "Group not found"
}
Rate limit exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMsg": "You have exceeded the maximum number of API calls. Please try again later."
}
Server error
{
"error_description": "Internal Server error, Please try again in a moment.",
"error_code": "COM0004"
}
![]()
Duration: 1 minute | Threshold: 60 | 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.