Retrieves a managed device's browser inventory, applied profiles and groups, and system information.
get /bsp/api/v1/bmp/devices/{device_id}/summary
https://{server-hostname}:8383/bsp/api/v1/bmp/devices/{device_id}/summary
BrowserManager.READCopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Device resource ID from List Devices response (device_id field)
curl --request GET \
--url https://appdomain/bsp/api/v1/bmp/devices/{device_id}/summary \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Device asset summary
Device summary object
Total number of distinct browsers
Total number of web domains visited
Operating system name
Device hostname
Operating system platform identifier
Browsers installed on the device
Individual browser entry within the device summary
Localized display name of the browser
Browser type identifier
Unique browser application ID on the device
Number of extensions installed
Number of plugins installed
Last agent contact time
Number of profiles associated
Number of extensions distributed
Number of custom groups
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
Internal server error during device operations
Message describing the server-side failure
Internal server error code
Device summary
{
"assetsummary": {
"platform_type": 1,
"group_count": 2,
"browser_count": 2,
"contact_time": "Jan 15, 2026 09:45 AM",
"name": "WORKSTATION-XYZ",
"os_name": "Windows 11 Pro",
"webdomain_count": 25,
"browsers": [
{
"browser_name": "Microsoft Edge",
"browser_id": 102,
"browser_type": 4,
"plugin_count": 1,
"extension_count": 3
},
{
"browser_name": "Google Chrome",
"browser_id": 103,
"browser_type": 1,
"plugin_count": 0,
"extension_count": 8
}
],
"profile_count": 5,
"extension_distributed_count": 4
}
}
Unauthorized
{
"errorCode": "UNAUTHORIZED",
"errorMsg": "You are not authorized to perform this action"
}
Forbidden
{
"errorCode": "FORBIDDEN",
"errorMsg": "You do not have permission to access this resource"
}
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"
}
Device not found
{
"errorCode": "RESOURCE0001",
"errorMsg": "No computers are found."
}
![]()
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.