# Get a profile's deployment summary

Retrieves the deployment summary of a configuration profile.

## Endpoint

`GET /bsp/api/v1/bmp/profiles/{profile_id}/summary`

### Request URL

`https://`[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/bsp/api/v1/bmp/profiles/{profile_id}/summary`

### Scope

`DesktopCentralCloud.BrowserManager.READ`

#### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** `string` — Mandatory — `application/json`

#### Path Parameters

- **profile_id** `string` — Mandatory  
  Retrieve the configuration profile ID from the profileid key in the response returned by [List Configuration Profiles](https://www.manageengine.com/products/desktop-central/help/api/cloud/profiles-list-profiles.html)

### Sample Request

```curl
curl --request GET \
  --url https://appdomains/bsp/api/v1/bmp/profiles/{profile_id}/summary \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

Response Body — `application/json`

`JSON Object`

Deployment status summary including target counts, applied/failed/pending statistics, and version info.

- **all_target** `string` — Total target devices
- **applied_target** `string` — Successfully applied count
- **yet_to_apply** `string` — Pending count
- **failed** `string` — Failed count
- **notification_sent** `string` — Notification sent count
- **not_applicable** `string` — Not applicable count
- **inprogress** `string` — In progress count
- **incomplete** `string` — Incomplete count
- **associated_devices** `string` — Associated devices count
- **associated_groups** `string` — Associated groups count
- **associated_users** `string` — Targeted users count
- **all_target_user** `string` — Total target users
- **created_time** `string` — Created timestamp (`EEE, dd MMM yyyy hh:mm:ss a`)
- **modified_time** `string` — Modified timestamp (`EEE, dd MMM yyyy hh:mm:ss a`)
- **latest_version** `string` — Latest version
- **is_published** `boolean` — Currently published
- **yet_to_update_devices** `string` — Devices needing update to latest version
- **yet_to_update_groups** `string` — Groups needing update to latest version

#### Sample Response: HTTP 200

Full deployment status summary for a published profile

```json
{
  "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"
}
```

### HTTP code 401

Response Body — `application/json`

`JSON Object`

- **errorCode** `long` — Unauthorized error code returned when authentication credentials are missing, expired, or invalid (`authentication=required`)
- **errorMsg** `string` — Authentication failure reason

#### Sample Response: HTTP 401

API key is missing or invalid

```json
{
  "errorCode": "IAM0001",
  "errorMsg": "Authentication key is invalid. Please regenerate the key and try again."
}
```

### HTTP code 403

Response Body — `application/json`

`JSON Object`

- **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

#### Sample Response: HTTP 403

Forbidden

```json
{
  "errorCode": "FORBIDDEN",
  "errorMsg": "User does not have permission to perform this operation"
}
```

### HTTP code 404

Response Body — `application/json`

`JSON Object`

Not found error when the specified profile ID does not exist.

- **errormsg** `string` — Human-readable message indicating the profile ID was not found

#### Sample Response: HTTP 404

The specified profile ID does not exist

```json
{
  "errormsg": "Profile ID not found"
}
```

### HTTP code 429

Response Body — `application/json`

`JSON Object`

- **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

#### Sample Response: HTTP 429

Rate limit exceeded

```json
{
  "errorCode": "RATE_LIMIT_EXCEEDED",
  "errorMsg": "Too many requests. Please try again after 5 minutes"
}
```

### HTTP code 500

Response Body — `application/json`

`JSON Object`

Internal server error response for profile operations.

- **error_description** `string` — Error message describing the server failure
- **error_code** `string` — Error code for internal server errors

#### Sample Response: HTTP 500

Server error

```json
{
  "error_description": "Internal Server error, Please try again in a moment.",
  "error_code": "COM0004"
}
```

## Rate Limits

**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.