---
title: Search device groups by device group name
slug: cps-guide/mdm-epmm/search-device-groups-by-device-group-name
createdAt: 2026-10-06T07:45:20.742Z
---

<font color="#000000">This call returns device group information for device groups whose name starts with the string specified in the search request.</font>

## HTTP Method

GET

## Request URI

/msa/v1/cps/rule?name=\<name>\&offset=\<Offset>\&limit=\<Limit>

## Request parameters

| Parameter | Description                                                                                                                                                                                                                                                              | Sample Value |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------ |
| name      | **Required**<br />**Parameter Type:&#x20;**&#x51;uery<br />**Data Type:** String<br /><font color="#000000">The prefix string of the device group name on which to perform the search. Not context sensitive. No records are returned if this parameter is blank.</font> | iOS          |

## Response fields

A list of device groups.

See [Rules](docId\:DK5wUaGcE74hME-EUyNkR).

## Example response

```javascript
{
    "searchResults": [
        {
            "id": 38089, 
            "name": "rule1", 
            "description": "Rule 1 Description", 
            "definition": "PLATFORMTYPE EQ 'IOS'"
        }, 
        {
            "id": 38090, 
            "name": "rule2", 
            "description": "Rule 2 Description", 
            "definition": "CFDEVICE[nacCompliant] EQ 'false'"
        }
    ], 
    "results": 2, 
    "offset": 0, 
    "limit": 10
}
```