# Retrieves available criteria columns for building dynamic custom group filters

Returns all available criteria columns grouped by category (computer, ipRange, etc.). Each column includes its ID, display name, data type, column category, and list of applicable comparison operators. This endpoint is typically the first call when building a dynamic custom group filter. Use the returned columnId, comparator, and criteriaValue options to build the criteriaList when calling [Create Dynamic CG](https://www.manageengine.com/products/desktop-central/help/api/cloud/custom-groups-create-dynamic-cg.html) or [Update Dynamic CG](https://www.manageengine.com/products/desktop-central/help/api/cloud/custom-groups-update-dynamic-cg.html). To discover valid values for a specific column, call [Get Dynamic CG Column Values](https://www.manageengine.com/products/desktop-central/help/api/cloud/custom-groups-get-dynamic-cgcolumn-values.html) with the columnId from this response.

## Endpoints

`GET /api/1.4/customgroup/dynamic/criteriaPattern`

## Request URL

`https://`[*{serverurl}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/api/1.4/customgroup/dynamic/criteriaPattern`

## Scope

`DesktopCentralCloud.Common.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` — **Mandatory**  
  `application/json`

  Must be application/json. Only JSON responses are supported.

## Sample Request

### Curl

```curl
curl --request GET \
  --url https://appdomains/api/1.4/customgroup/dynamic/criteriaPattern \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

#### Response Body — application/json

`JSON Object`

- **message_type** `string`  
  Always 'dynamic' 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 code 500

#### Response Body — application/json

`JSON Object`

- **message_type** `string`  
  Always 'dynamic' 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.

## Possible Response Codes

- **200** — HTTP code
- **500** — HTTP code

## Sample Response: HTTP 200

Criteria columns grouped by resolved COLUMN_CATEGORY with real column IDs from customGroup-criteria.xml.

```json
{
  "message_type": "dynamic",
  "message_response": {
    "dynamic": {
      "Computer": [
        {
          "columnCategory": "Computer",
          "columnId": 3,
          "displayName": "System Type",
          "applicableCriteriaType": [
            {
              "label": "is",
              "value": "equal"
            }
          ],
          "columnValue": "PROCESSOR_ARCH_NAME"
        },
        {
          "columnCategory": "Computer",
          "columnId": 11,
          "displayName": "IP Address",
          "applicableCriteriaType": [
            {
              "label": "is",
              "value": "equal"
            }
          ],
          "columnValue": "IPADDR_LONG"
        }
      ],
      "Operating System": [
        {
          "columnCategory": "Operating System",
          "columnId": 1,
          "displayName": "Operating System",
          "applicableCriteriaType": [
            {
              "label": "is",
              "value": "equal"
            },
            {
              "label": "is not",
              "value": "not equal"
            },
            {
              "label": "contains",
              "value": "contains"
            },
            {
              "label": "does not contain",
              "value": "not contains"
            }
          ],
          "columnValue": "OS_NAME"
        },
        {
          "columnCategory": "Operating System",
          "columnId": 2,
          "displayName": "OS Version",
          "applicableCriteriaType": [
            {
              "label": "is",
              "value": "equal"
            },
            {
              "label": "is not",
              "value": "not equal"
            }
          ],
          "columnValue": "OS_VERSION"
        }
      ],
      "Software": [
        {
          "columnCategory": "Software",
          "columnId": 5,
          "displayName": "Software Name",
          "applicableCriteriaType": [
            {
              "label": "is",
              "value": "equal"
            },
            {
              "label": "contains",
              "value": "contains"
            }
          ],
          "columnValue": "SOFTWARE_NAME"
        },
        {
          "columnCategory": "Software",
          "columnId": 6,
          "displayName": "Software Version",
          "applicableCriteriaType": [
            {
              "label": "is",
              "value": "equal"
            },
            {
              "label": "is not",
              "value": "not equal"
            }
          ],
          "columnValue": "SOFTWARE_VERSION"
        }
      ]
    }
  },
  "message_version": "1.4",
  "status": "success"
}
```

## Sample Response: HTTP 500

Unexpected server-side failure retrieving criteria pattern.

```json
{
  "error_description": "An internal error occurred while processing the request.",
  "message_type": "dynamic",
  "error_code": "1003",
  "message_version": "1.4",
  "status": "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.