Returns device counts grouped by time range. Use status=contacts for last contact time or status=scans for last scan time.
get /bsp/api/v1/bmp/devices/summary/{status}
https://{server-hostname}:8383/bsp/api/v1/bmp/devices/summary/{status} Copied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Summary type: 'scans' for scan activity or 'contacts' for device contact time
curl --request GET \
--url https://appdomain/bsp/api/v1/bmp/devices/summary/{status} \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Device contact summary grouped by time buckets
Contact time buckets with device counts
Contact time bucket with device count
Time bucket label for agent contact period
Number of devices contacted within this time bucket
Time bucket label for agent contact period
Number of devices contacted within this time bucket
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
Internal server error during device operations
Message describing the server-side failure
Internal server error code
Contact summary
{
"devices": [
{
"device_contacted_in": "3_days",
"contacted_count": "0"
},
{
"device_contacted_in": "4_7_days",
"contacted_count": "0"
},
{
"device_contacted_in": "8_15_days",
"contacted_count": "0"
},
{
"device_contacted_in": "16_30_days",
"contacted_count": "0"
},
{
"device_contacted_in": "30_days",
"contacted_count": "0"
}
]
}
Scan summary
{
"devices": [
{
"device_scanned_in": "3_days",
"scanned_count": "0"
},
{
"device_scanned_in": "4_7_days",
"scanned_count": "0"
},
{
"device_scanned_in": "8_15_days",
"scanned_count": "0"
},
{
"device_scanned_in": "16_30_days",
"scanned_count": "0"
},
{
"device_scanned_in": "30_days",
"scanned_count": "0"
}
]
}
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"
}
![]()
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.