---
title: Example device groups API scenario
slug: cps-guide/mdm-epmm/example-device-groups-api-scenario
createdAt: 2026-10-06T07:45:20.760Z
---

You can use the device group APIs to calculate device group characteristics, such as the percentage of Android Enterprise-enrolled devices. Remember that device groups are “device groups” on Ivanti Neurons for MDM, and “labels” on Ivanti EPMM.

## Example

|   | 1. | First, use the [Get all Device Groups](docId\:sXn099Msm3Scw0GndRXg3) call to get a list of all the device groups, so you know which device groups you can use for your calculations. |
| - | -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

Call:

GET msa/v1/cps/rule

Response:

```javascript
{
    "searchResults": [
        {
            "id": 38000, 
            "name": "All Devices", 
            "description": "Targets any type of device."
        }, 
        {
            "id": 38001, 
            "name": "Android Devices", 
            "description": "Targets all Android devices", 
            "definition": "PLATFORMTYPE EQ 'ANDROID'"
        }, 
        {
            "id": 38002, 
            "name": "Android Enterprise Devices", 
            "description": "Targets all Android Enterprise devices", 
            "definition": "PLATFORMTYPE EQ 'ANDROID' AND ANDROIDWORKENABLED EQ 'true'"
        }, 
        {
            "id": 38003, 
            "name": "iOS Devices", 
            "description": "Targets all iOS devices", 
            "definition": "PLATFORMTYPE EQ 'IOS'"
        }, 
        {
            "id": 38004, 
            "name": "Windows Devices", 
            "description": "Targets all Windows devices", 
            "definition": "PLATFORMTYPE EQ 'WINDOWS_PHONE'"
        }, 
        {
            "id": 38005, 
            "name": "macOS Devices", 
            "description": "Targets all OSX devices", 
            "definition": "PLATFORMTYPE EQ 'OSX'"
        }, 
        {
            "id": 38006, 
            "name": "tvOS Devices", 
            "description": "Targets all tvOS devices.", 
            "definition": "PLATFORMTYPE EQ 'IOS' AND MODEL STARTS_WITH 'AppleTV')"
        }
    ], 
    "results": 7, 
    "offset": 0, 
    "limit": 50
}
```

|   | 2. | Use the [Count devices by device group identifier](docId\:pnl1qdfCnbk5fmRdHtzN7) call to find the total android device count. |
| - | -- | ----------------------------------------------------------------------------------------------------------------------------- |

Call:

GET : /msa/v1/cps/device?ruleId=38001

Note that ruleId 38001 targets all Android devices.

|   | 3. | Use the [Count devices by device group identifier](docId\:pnl1qdfCnbk5fmRdHtzN7) and then the number of Android Enterprise-enrolled devices. |
| - | -- | -------------------------------------------------------------------------------------------------------------------------------------------- |

Call:

GET : /msa/v1/cps/device?ruleId=38002

Note that ruleId 38002 targets all Android Enterprise-enrolled devices.

|   | 4. | Using the two values returned by the preceding two calls, you can calculate the percentage of Android devices that are also Android Enterprise-enrolled devices. |
| - | -- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |