# Get network-wide compliance overview (default profile) Returns a network-wide compliance and vulnerability summary across all managed devices. ## Endpoint `GET /bsp/api/v1/bmp/compliance` ## Request ### Request URL `https://{server-hostname}:8383/bsp/api/v1/bmp/compliance` ### Scope `BrowserManager.READ` ### Header `Authorization: d92d4xxxxxxxxxxxxx15f52` ### Request Parameters #### Request Headers - **Accept** `string` **Mandatory**: `application/json` ### Sample Request ```curl curl --request GET \ --url https://appdomain/bsp/api/v1/bmp/compliance \ --header 'Accept: application/json' \ --header 'Authorization: d92d4xxxxxxxxxxxxx15f52' ``` ## Response Parameters ### HTTP 200 #### Response Body — application/json `JSON Object` | Attribute | Type | Description | |---|---|---| | VeryHighVul | string | Count of devices with very high vulnerability risk | | HighVul | string | Count of devices with high vulnerability risk | | LowRisk | string | Count of devices with low vulnerability risk | | Secure | string | Count of devices classified as secure | | compliant | string | Total count of compliant devices | | noncompliant | string | Total count of noncompliant devices | ### HTTP 401 #### Response Body — application/json `JSON Object` | Attribute | Type | Description | |---|---|---| | errorCode | long | Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required) | | errorMsg | string | Authentication failure reason | ### HTTP 403 #### Response Body — application/json `JSON Object` | Attribute | Type | Description | |---|---|---| | errorCode | long | Forbidden error code returned when the authenticated user does not have the required uem-roles (e.g., DataEncryption_Admin or DataEncryptionRecoveryKey_Admin) | | errorMsg | string | Message indicating insufficient privileges to access this resource | ### HTTP 429 #### Response Body — application/json `JSON Object` | Attribute | Type | Description | |---|---|---| | errorCode | long | 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 | | errorMsg | string | Rate limit exceeded message with retry guidance | ### HTTP 500 #### Response Body — application/json `JSON Object` | Attribute | Type | Description | |---|---|---| | error_description | string | Message describing the server-side failure | | error_code | string | Internal server error code | ### Possible Response Codes - `200` — HTTP code - `401` — HTTP code - `403` — HTTP code - `429` — HTTP code - `500` — HTTP code ### Sample Response: HTTP 200 Network-wide overview against the default compliance profile ```json { "noncompliant": 17, "HighVul": 12, "LowRisk": 30, "Secure": 150, "compliant": 180, "VeryHighVul": 5 } ``` ### Sample Response: HTTP 401 Unauthorized ```json { "errorCode": "UNAUTHORIZED", "errorMsg": "You are not authorized to perform this action" } ``` ### Sample Response: HTTP 403 Forbidden ```json { "errorCode": "FORBIDDEN", "errorMsg": "You do not have permission to access this resource" } ``` ### Sample Response: HTTP 429 Rate limit exceeded ```json { "errorCode": "RATE_LIMIT_EXCEEDED", "errorMsg": "You have exceeded the maximum number of API calls. Please try again later." } ``` ### Sample Response: HTTP 500 Server error ```json { "error_description": "Internal Server error, Please try again in a moment.", "error_code": "COM0004" } ``` ## Rate Limiting ![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png) **Duration:** 1 minute | **Threshold:** 120 | **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.