Retrieves the summary details of an add-on, including its name, identifier, and installation count.
get /bsp/api/v1/bmp/addons/{binary_id}
https://{server-hostname}:8383/bsp/api/v1/bmp/addons/{binary_id} Copied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Add-on binary ID from List Add-Ons or Import Add-Ons response (binary_id field)
curl --request GET \
--url https://appdomain/bsp/api/v1/bmp/addons/{binary_id} \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Number of managed devices with this addon installed
Addon display name
Addon identifier webstore ID for extensions, CLSID for plugins
Message indicating the addon type is not supported
Unauthorized error code: API key or OAuth token missing, expired or invalid
Authentication failure reason
Forbidden error code: the user lacks the required MDM_OSUpdateMgmt UEM role
Message indicating insufficient privileges
Rate limit error code: API call threshold exceeded for this endpoint group
Rate limit exceeded message with retry guidance
Message describing the internal server error
Error code identifying the type of server error
Chrome extension summary
{
"count": 25,
"name": "uBlock Origin",
"id": "cjpalhdlnbpafiamejdnhcphjbkeiagm"
}
Plugin summary
{
"count": 10,
"name": "Java Plugin",
"id": "{CAFEEFAC-0018-0000-FFFF-ABCDEFFEDCBA}"
}
Addon with no installations
{
"count": 0,
"name": "Dark Reader",
"id": "eimadpbcbfnmbkopoojfekhnkhdbieeh"
}
Unsupported addon type
{
"error_description": "Binary Type not supported"
}
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"
}
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.