# 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://{server-hostname}:8383/dcapi/scap/compliance/map/CGMapDetails`

### Scope

`VulnerabilityMgmt.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Sample Request

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

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

### 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"
}
```

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

User lacks scope access to the custom group

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

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

API call threshold exceeded

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

## Possible Response Codes

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

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