# Get a profile's deployment summary

Retrieves the deployment summary of a configuration profile.

## Endpoints

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

## Request

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

| Parameter | Type | Required | Value |
|---|---|---|---|
| Accept | string | Mandatory | application/json |

#### Path Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| 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`

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

| Attribute | Type | Description |
|---|---|---|
| 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`

| Attribute | Type | Description |
|---|---|---|
| errorCode | long | Unauthorized error code: credentials missing, expired, or invalid |
| 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`

| Attribute | Type | Description |
|---|---|---|
| errorCode | long | Error code indicating insufficient permissions |
| 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`

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

| Attribute | Type | Description |
|---|---|---|
| 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`

| Attribute | Type | Description |
|---|---|---|
| errorCode | long | Rate limit error code returned when the API call reached threshold |
| 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`

Internal server error response for profile operations.

| Attribute | Type | Description |
|---|---|---|
| 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"
}
```

## Possible Response Codes

- `200` — HTTP code
- `401` — HTTP code
- `403` — HTTP code
- `404` — HTTP code
- `429` — HTTP code
- `500` — HTTP code

## Rate Limit

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