Get device groups associated with device list

This call returns a list of device groups and related information associated with a list of devices. Device groups correspond to rule IDs.

HTTP Method

POST

Request URI

/msa/v1/cps/rule/deviceGuid

Request parameters

 

Parameter

Description

Sample Value

identifiers

Required

Parameter Type: Request body

Data Type: String

List of device GUIDs identifiers in this format:

{
    "identifiers": [
        "deviceGuid"
    ]
}

See List of identifiers.

{
"identifiers": [
"6b8df48e-7778-4a33-97e4-1cc6b39de61c"
]
}

Response fields

A list of device groups.

See Rules.

Example request

curl --location --request POST 'https://[mobileiron-Ivanti Neurons for MDM-or-Ivanti EPMM]/msa/v1/cps/rule/deviceGuid' \
--header 'Accept: application/json, text/plain, */*' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic xxxxxEBzYW5kYm94Lm1vYmlsZWlyb24uY29tOk1pNG1hbjEx' \
--data-raw {
    "identifiers": [
        "6b8df48e-7778-4a33-97e4-1cc6b39de61c"
    ]
}

Example response

{
    "errors": null, 
    "result": [
        {
            "deviceGuid": "6b8df48e-7778-4a33-97e4-1cc6b39de61c", 
            "rules": [
                {
                    "id": 51173, 
                    "name": "jk Sandbox User Group", 
                    "definition": "DISPLAYNAME EQ 'jk Sandbox User'"
                }, 
                {
                    "id": 390113, 
                    "name": "test#2", 
                    "definition": "CURRENTMCC NEQ 'test#'"
                }, 
                {
                    "id": 361609, 
                    "name": "Bozo", 
                    "definition": "UNLOCK_TOKEN EQ 'TRUE'"
                }, 
                {
                    "id": 40165, 
                    "name": "All Devices", 
                    "description": "Targets any type of device."
                }, 
                {
                    "id": 118493, 
                    "name": "current country", 
                    "definition": "CURRENTCOUNTRYNAME EQ 'United States'"
                }, 
                {
                    "id": 40167, 
                    "name": "iOS Devices", 
                    "description": "Targets all iOS devices", 
                    "definition": "PLATFORMTYPE EQ 'IOS'"
                }
            ]
        }
    ]
}