# Retrieves detailed information for a specific custom group by name

Returns complete details of a custom group identified by name. Fetch the cgName from [Retrieve All Custom Groups](https://www.manageengine.com/products/desktop-central/help/api/cloud/custom-groups-get-cglist.html). For static groups, includes the list of member resources and associated domains. For dynamic groups, includes the criteria list, renderability status, and filter criteria used for automatic member population — column definitions referenced in the returned criteriaList (`columnId`, `columnValue`, `comparator`) are documented at [Get Dynamic CG Criteria Pattern](https://www.manageengine.com/products/desktop-central/help/api/cloud/custom-groups-get-dynamic-cgcriteria-pattern.html).

## Endpoint

`GET /api/1.4/customgroup/getCGDetails`

## Request URL

`https://{serverurl}/api/1.4/customgroup/getCGDetails`

`{serverurl}` is documented at [OAuth Authentication Endpoint Domain](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html).

## Scope

`DesktopCentralCloud.Common.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

| Parameter | Type | Required | Value | Description |
|---|---|---|---|---|
| Accept | string | Mandatory | `application/json` | Must be `application/json`. Only JSON responses are supported. |

### Query Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| cgName | string | Mandatory | Exact name of the custom group to retrieve. Case-sensitive match. Fetch names from [Retrieve All Custom Groups](https://www.manageengine.com/products/desktop-central/help/api/cloud/custom-groups-get-cglist.html). |

## Sample Request

```curl
curl --request GET \
  --url 'https://appdomains/api/1.4/customgroup/getCGDetails?cgName=SOME_STRING_VALUE' \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP 200

Response body: `application/json`

| Parameter | Type | Description |
|---|---|---|
| message_type | string | Always `getCGDetails` for this endpoint. |
| message_response | JSON Object | Response payload container. |
| message_version | string | API version: `1.4`. |
| status | string | `success` when the request completed without errors. |

### HTTP 204

Response body: `application/json`

| Parameter | Type | Description |
|---|---|---|
| message_type | string | Always `getCGDetails` for this endpoint. |
| message_version | string | API version: `1.4`. |
| status | string | Always `error` for error responses. |
| error_code | string | Internal error code: `20015` (group name does not exist). |
| error_description | string | Human-readable error message. |

### HTTP 412

Response body: `application/json`

| Parameter | Type | Description |
|---|---|---|
| message_type | string | Always `getCGDetails` for this endpoint. |
| message_version | string | API version: `1.4`. |
| status | string | Always `error` for error responses. |
| error_code | string | Internal error code: `20011` (group name empty). |
| error_description | string | Human-readable error message. |

### HTTP 417

Response body: `application/json`

| Parameter | Type | Description |
|---|---|---|
| message_type | string | Always `getCGDetails` for this endpoint. |
| message_version | string | API version: `1.4`. |
| status | string | Always `error` for error responses. |
| error_code | string | Internal error code: `20003` (no managed domains). |
| error_description | string | Human-readable error message. |

### HTTP 500

Response body: `application/json`

| Parameter | Type | Description |
|---|---|---|
| message_type | string | Always `getCGDetails` for this endpoint. |
| message_version | string | API version: `1.4`. |
| status | string | Always `error` for error responses. |
| error_code | string | Internal error code: `1003` (`INTERNAL_ERROR`). |
| error_description | string | Resolved I18N message, typically: An internal error occurred while processing the request. |

## Rate Limit

**Duration:** 1 minute | **Threshold:** 30 | **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.