# Retrieves data rule details by ID

Retrieves the detailed summary of a specific data rule by its unique identifier.

## Endpoint

`GET /endpointdlp/api/data-classification/data-rule/data-rule-details/{dataRuleId}`

## Request URL

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

## Scope

`DesktopCentralCloud.EndpointDLP.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` — Mandatory
  - `application/dataRuleDetail.v1+json`

### Path Parameters

- **dataRuleId** `string` — Mandatory
  - Unique identifier of the data rule. Fetch from [Get All Data Rules](https://www.manageengine.com/products/desktop-central/help/api/cloud/edlp-get-all-data-rules.html)

## Sample Request

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

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

- `JSON Object`
  - **dataRuleDetail** `JSON Object`
    - Data rule detail wrapper
    - **dataRuleName** `string`
      - Name of the data rule
    - **dataRuleId** `string`
      - Unique identifier of the data rule
    - **dataRuleType** `integer`
      - Type of the data rule (1=Predefined, 2=Custom)
    - **dataRuleDescription** `string`
      - Description of the data rule
    - **noOfOccurrence** `string`
      - Number of occurrences threshold
    - **subRuleTypeId** `integer`
      - Sub-rule type identifier (1=Regex, 2=Keyword, 3=Fingerprint)
    - **regexSubRuleBean** `JSON Object`
      - Regex sub-rule details (present when subRuleTypeId=1)
    - **keywordSubRuleBean** `JSON Object`
      - Keyword sub-rule details (present when subRuleTypeId=2)
    - **fingerprintSubRuleBean** `JSON Object`
      - Fingerprint sub-rule details (present when subRuleTypeId=3)
    - **extensionList** `array`
      - List of file extensions to scan
    - **dataRuleName** `string`
      - Name of the data rule
    - **dataRuleId** `string`
      - Unique identifier of the data rule
    - **dataRuleType** `integer`
      - Type of the data rule (1=Predefined, 2=Custom)
    - **dataRuleDescription** `string`
      - Description of the data rule
    - **noOfOccurrence** `string`
      - Number of occurrences threshold
    - **subRuleTypeId** `integer`
      - Sub-rule type identifier (1=Regex, 2=Keyword, 3=Fingerprint)
    - **regexSubRuleBean** `JSON Object`
      - Regex sub-rule details (present when subRuleTypeId=1)
    - **keywordSubRuleBean** `JSON Object`
      - Keyword sub-rule details (present when subRuleTypeId=2)
    - **fingerprintSubRuleBean** `JSON Object`
      - Fingerprint sub-rule details (present when subRuleTypeId=3)
    - **extensionList** `array`
      - List of file extensions to scan

### Sample Response: HTTP 200

Successful retrieval of data rule details

```json
{
  "dataRuleDetail": {
    "regexSubRuleBean": {
      "dictionaryWordList": [],
      "regexValueList": [
        "\\d{3}-\\d{2}-\\d{4}"
      ]
    },
    "keywordSubRuleBean": null,
    "dataRuleId": "1000045",
    "noOfOccurrence": "3",
    "dataRuleDescription": "Detects US Social Security Numbers",
    "extensionList": [
      "txt",
      "csv",
      "pdf"
    ],
    "dataRuleName": "US Social Security Number",
    "dataRuleType": 1,
    "fingerprintSubRuleBean": null,
    "subRuleTypeId": 1
  }
}
```

### HTTP Code 500

Response Body — `application/json`

- `JSON Object`
  - **errorCode** `string`
    - Internal error code returned when fetching data rule details by ID fails
  - **errorMessage** `string`
    - Failure message describing why the data rule details could not be retrieved

### Sample Response: HTTP 500

Internal server error

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

![ ](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.