Retrieves the deployment summary of a configuration profile.
get /bsp/api/v1/bmp/profiles/{profile_id}/summary
https://{server-hostname}:8383/bsp/api/v1/bmp/profiles/{profile_id}/summary
BrowserManager.READCopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Retrieve the configuration profile ID from the profileid key in the response returned by List Configuration Profiles
curl --request GET \
--url https://appdomain/bsp/api/v1/bmp/profiles/{profile_id}/summary \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Deployment status summary including target counts, applied/failed/pending statistics, and version info
Total target devices
Successfully applied count
Pending count
Failed count
Notification sent count
Not applicable count
In progress count
Incomplete count
Associated devices count
Associated groups count
Targeted users count
Total target users
Created timestamp (EEE, dd MMM yyyy hh:mm:ss a)
Modified timestamp (EEE, dd MMM yyyy hh:mm:ss a)
Latest version
Currently published
Devices needing update to latest version
Groups needing update to latest version
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
Not found error when the specified profile ID does not exist
Human-readable message indicating the profile ID 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
Internal server error response for profile operations
Error message describing the server failure
Error code for internal server errors
Full deployment status summary for a published profile
{
"applied_target": "80",
"notification_sent": "2",
"created_time": "Tue, 14 Apr 2026 03:25:17 PM",
"yet_to_apply": "5",
"is_published": true,
"inprogress": "3",
"associated_users": "10",
"failed": "3",
"associated_devices": "90",
"all_target": "100",
"yet_to_update_groups": "1",
"incomplete": "2",
"modified_time": "Tue, 14 Apr 2026 03:27:37 PM",
"associated_groups": "5",
"latest_version": "3",
"yet_to_update_devices": "5",
"not_applicable": "5",
"all_target_user": "10"
}
API key is missing or invalid
{
"errorCode": "IAM0001",
"errorMsg": "Authentication key is invalid. Please regenerate the key and try again."
}
Forbidden
{
"errorCode": "FORBIDDEN",
"errorMsg": "User does not have permission to perform this operation"
}
The specified profile ID does not exist
{
"errormsg": "Profile ID not found"
}
Rate limit exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMsg": "Too many requests. Please try again after 5 minutes"
}
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.