# Get an add-on management profile's full details

Retrieves the full details of an add-on management profile, including its metadata and payload configurations.

## Endpoint

`GET /bsp/api/v1/bmp/manage_addons/{addon_id}`

## Request

### Request URL

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

### Scope

`DesktopCentralCloud.BrowserManager.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

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

#### Path Parameters

- **addon_id** `string` **Mandatory**: Add-On Management Profile ID from [List Add-On Management Profiles](https://www.manageengine.com/products/desktop-central/help/api/cloud/add-on-management-list-addon-profiles.html) response (`manage_addon_id` field)

### Sample Request

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

## Response Parameters

### HTTP 200

Response Body — `application/json`

- `JSON Object`
  - **collection_id** `string`: Collection reference ID for the profile
  - **profile_type** `string`: Profile type identifier
  - **platform_type** `string`: Platform type. 1=Windows, 2=Mac, -1=All platforms
  - **latest_version** `string`: Latest version number of the profile
  - **is_moved_to_trash** `boolean`: Whether the profile is in the trash
  - **manage_addon_name** `string`: Profile display name
  - **scope** `string`: Profile scope. 0=device, 1=user
  - **latest_published_version** `string`: Latest published version, or '--' if not yet published
  - **manage_addon_description** `string`: Profile description
  - **manage_addon_id** `string`: Unique profile identifier
  - **addon_payloads** `JSON Array`: Payload configurations associated with this profile

### HTTP 400

Response Body — `application/json`

- `JSON Object`
  - **errorcode** `string`: Error code indicating the request is invalid
  - **errormsg** `string`: Message describing why the request is invalid

### HTTP 401

Response Body — `application/json`

- `JSON Object`
  - **errorCode** `long`: Unauthorized error code: credentials missing, expired, or invalid
  - **errorMsg** `string`: Authentication failure reason

### HTTP 403

Response Body — `application/json`

- `JSON Object`
  - **errorCode** `long`: Error code indicating insufficient permissions
  - **errorMsg** `string`: Message indicating insufficient privileges to access this resource

### HTTP 429

Response Body — `application/json`

- `JSON Object`
  - **errorCode** `long`: Rate limit error code returned when the API call reached threshold
  - **errorMsg** `string`: Rate limit exceeded message with retry guidance

### HTTP 500

Response Body — `application/json`

- `JSON Object`
  - **errormsg** `string`: Message describing the internal server error

### Sample Response: HTTP 200

Profile with Chrome payload

```json
{
  "collection_id": "222",
  "profile_type": "64025",
  "platform_type": "1",
  "latest_version": "1",
  "is_moved_to_trash": false,
  "manage_addon_name": "FullTest_Profile",
  "scope": "0",
  "latest_published_version": "--",
  "manage_addon_description": "Full test run",
  "manage_addon_id": "996",
  "addon_payloads": [
    {
      "restrict_permissions": "1",
      "config_name": "MANAGE_CHROME_ADDONS",
      "payload_type": "64125",
      "restrict_domains": "-1",
      "payload_id": "1164",
      "binaries_details": [
        {
          "browser_type": "1",
          "name": "Google Translate",
          "binary_id": "30",
          "id": "aapbdbdomjkkjkaonfhkkikfgjllcleb"
        }
      ],
      "permissions": [
        {
          "name": "Context menu",
          "id": "10"
        }
      ],
      "pinned_binaries_details": [
        {
          "browser_type": "1",
          "name": "Google Translate",
          "binary_id": "30",
          "id": "aapbdbdomjkkjkaonfhkkikfgjllcleb"
        }
      ],
      "browser_type": "1",
      "policies": {
        "disable_user_extensions": "1",
        "allow_flash": "-1"
      },
      "restrict_addons": "1",
      "native_hosts": {
        "native_permission": "-1",
        "native_details": []
      }
    }
  ]
}
```

### Sample Response: HTTP 400

Invalid profile ID

```json
{
  "errorcode": "IAM0003",
  "errormsg": "Invalid request."
}
```

### Sample Response: HTTP 401

Unauthorized

```json
{
  "errorCode": "UNAUTHORIZED",
  "errorMsg": "You are not authorized to perform this action"
}
```

### Sample Response: HTTP 403

Insufficient permissions

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

### Sample Response: HTTP 429

Rate limit exceeded

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

### Sample Response: HTTP 500

Server error

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

### Possible Response Codes

- **200** `HTTP code`
- **400** `HTTP code`
- **401** `HTTP code`
- **403** `HTTP code`
- **429** `HTTP code`
- **500** `HTTP code`

## Rate Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

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