# Fetch compliance target group association configuration

Retrieves the full configuration details for a compliance custom group (target group), including associated policies, scheduler settings, deployment status, and notification preferences.

## Endpoint

`GET /dcapi/scap/compliance/map/CGMapDetails`

## Request

### Request URL

`https://`[serverurl](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/dcapi/scap/compliance/map/CGMapDetails`

### Scope

`DesktopCentralCloud.VulnerabilityMgmt.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Query Parameters

- **groupResourceId** — `long` *(Optional)*: The resource ID of the custom group to fetch details for

### Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/scap/compliance/map/CGMapDetails \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Responses

### Response Parameters

#### HTTP Code 200

Response body: `application/json`

`JSON Object`

- **customGroup** — `long`: Custom group resource ID
- **collectionId** — `long`: Associated collection ID
- **cgName** — `string`: Custom group name
- **compliancePolicies** — `array`: List of compliance policy group names associated with this target group
- **scheduler** — `JSON Object`: Scheduler configuration details including schedule type and timing
- **status** — `string`: Collection deployment status
- **ENABLE_EMAIL_NOTIFY** — `boolean`: Whether email notifications are enabled
- **EMAIL_DURATION** — `string`: Email notification duration setting
- **EMAIL_ENABLED_DAYS** — `string`: Comma-separated days when email notifications are active
- **EMAIL** — `string`: Notification email address
- **ENABLE_MOBILE_NOTIFY_FOR_USERS** — `array`: List of users enabled for mobile notifications

#### HTTP Code 401

Response body: `application/json`

`JSON Object`

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

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

### Possible Response Codes

- **200** — HTTP code
- **401** — HTTP code
- **429** — HTTP code

### Sample Response: HTTP 200

Full configuration details for a compliance target group

```json
{
  "scheduler": {
    "dailyTime": "02:00",
    "scheduleType": "Daily",
    "schedulerEnabled": true,
    "dailyIntervalType": "everyDay"
  },
  "compliancePolicies": [
    "CIS Windows Server 2019 L1",
    "CIS Windows Server 2019 L2"
  ],
  "ENABLE_EMAIL_NOTIFY": true,
  "customGroup": 301,
  "EMAIL_DURATION": "1",
  "EMAIL_ENABLED_DAYS": "1,2,3,4,5",
  "EMAIL": "admin@company.com",
  "ENABLE_MOBILE_NOTIFY_FOR_USERS": [
    "user1",
    "user2"
  ],
  "collectionId": 5001,
  "cgName": "Production Servers",
  "status": "Deployed"
}
```

### Sample Response: HTTP 401

User lacks scope access to the custom group

```json
{
  "errorMessage": "User Not Authorized",
  "errorCode": "UAC_UNAUTHORIZED"
}
```

### Sample Response: HTTP 429

API call threshold exceeded

```json
{
  "errorMessage": "Rate limit exceeded. Retry after some time",
  "errorCode": "TOO_MANY_REQUESTS"
}
```

## Rate Limits

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

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