# Retrieves data group details by ID

Retrieves the full details of a specific data group by its unique identifier, including all associated data rules.

## Endpoint

`GET /endpointdlp/api/data-classification/data-group/data-group-details/{dataGroupId}`

## Request URL

`https://`[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/endpointdlp/api/data-classification/data-group/data-group-details/{dataGroupId}`

### Scope

`DesktopCentralCloud.EndpointDLP.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

| Parameter | Type | Required | Value |
|---|---|---|---|
| Accept | string | Mandatory | `application/dataGroupDetail.v1+json` |

#### Path Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataGroupId | string | Mandatory | Unique identifier of the data group. Fetch from [Get All Data Groups](https://www.manageengine.com/products/desktop-central/help/api/cloud/edlp-get-all-data-groups.html) |

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/endpointdlp/api/data-classification/data-group/data-group-details/{dataGroupId} \
  --header 'Accept: application/dataGroupDetail.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

Response body: `application/json`

| Parameter | Type | Description |
|---|---|---|
| dataGroupDetail | JSON Object | Data group detail wrapper |

### HTTP Code 500

Response body: `application/json`

| Parameter | Type | Description |
|---|---|---|
| errorCode | string | Internal error code returned when fetching data group details by ID fails |
| errorMessage | string | Failure message describing why the data group could not be retrieved |

## Sample Response: HTTP 200

Successful retrieval of data group details containing one rule of each sub-rule type (regex, keyword, fingerprint).

```json
{
  "dataGroupDetail": {
    "dataGroupId": "1",
    "createdUserId": "101",
    "lastModifiedTime": "1775466405627",
    "creationTime": "1775457447117",
    "dataGroupDescription": null,
    "dataRuleSummaryBeanList": [
      {
        "regexSubRuleBean": {
          "dictionaryWordList": [],
          "regexValueList": [
            "\\d{4}-\\d{4}-\\d{4}-\\d{4}"
          ]
        },
        "keywordSubRuleBean": null,
        "dataRuleId": "1000002",
        "noOfOccurrence": "1",
        "dataRuleDescription": null,
        "extensionList": null,
        "dataRuleName": "Credit Card Number Rule",
        "dataRuleType": 1,
        "fingerprintSubRuleBean": null,
        "subRuleTypeId": 1
      },
      {
        "regexSubRuleBean": null,
        "keywordSubRuleBean": {
          "fileDetailBean": {
            "fileName": "confidential-keywords.txt",
            "fileLocation": "/dlp/refdata/uploads/confidential-keywords.txt"
          },
          "caseSensitive": false
        },
        "dataRuleId": "1000003",
        "noOfOccurrence": "1",
        "dataRuleDescription": null,
        "extensionList": null,
        "dataRuleName": "Confidential Keyword Rule",
        "dataRuleType": 2,
        "fingerprintSubRuleBean": null,
        "subRuleTypeId": 2
      },
      {
        "regexSubRuleBean": null,
        "keywordSubRuleBean": null,
        "dataRuleId": "1000004",
        "noOfOccurrence": "1",
        "dataRuleDescription": null,
        "extensionList": null,
        "dataRuleName": "Source Code Fingerprint Rule",
        "dataRuleType": 2,
        "fingerprintSubRuleBean": {
          "fileDetailBean": {
            "fileName": "source-code-template.docx",
            "fileLocation": "/dlp/refdata/uploads/source-code-template.docx"
          }
        },
        "subRuleTypeId": 3
      }
    ],
    "labelId": "1",
    "lastModifiedUserId": "101",
    "customerId": "5001",
    "lastModifiedUser": "john.doe",
    "dataRuleDetails": [],
    "dataGroupName": "Credit Card Data Group",
    "createdUser": "john.doe"
  }
}
```

## Sample Response: HTTP 500

Internal server error.

```json
{
  "errorMessage": "Exception occurred while fetching DataGroup",
  "errorCode": "INTERNAL_ERROR"
}
```

## Rate Limits

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