---
title: Get devices by mdm or GUID identifiers
slug: cps-guide/mdm-epmm/get-devices-by-mdm-or-guid-identifiers
createdAt: 2026-10-06T07:45:20.647Z
---

This API returns the details of devices with the MDM or deviceGuid identifiers specified in the request body. It silently ignores invalid MDM and deviceGuid identifiers. In the following device details resturn, the MDM identifier is in the field "identifier," and the deviceGuid is in the field, "deviceGuid." Those are the values, for example, "d0838fa7ba1ee023c9ece9192589088325d7aa08" and "dbccbe70-7499-4676-88b0-a6d5d298752e" that you could use in the body of this call.

```javascript
{
    "compliant": true, 
    "quarantined": false, 
    "blocked": false, 
    "compromised": false, 
    "status": "ACTIVE", 
    "lastCheckInTime": 1581229664468, 
    "registrationTime": 1581229603492, 
    "identifier": "d0838fa7ba1ee023c9ece9192589088325d7aa08", 
    "macAddress": "8c:fe:57:b3:53:96", 
    "manufacturer": "Apple Inc.", 
    "model": "iPad7,5", 
    "os": "IOS", 
    "osVersion": "13.3", 
    "serialNumber": "GG7XP285JMVT", 
    "userId": "b2@m.com", 
    "userUuid": "b8e7fea0-4730-4bc5-a089-cfd631078b9e", 
    "iosUdid": "d0838fa7ba1ee023c9ece9192589088325d7aa08", 
    "ownership": "UNKNOWN", 
    "deviceGuid": "dbccbe70-7499-4676-88b0-a6d5d298752e"
}
```

## HTTP Method

POST

## Request URI

/msa/v1/cps/device/uuid

## Request parameters

| Parameter      | Description                                                                                                                                                                                                                                                                                                                                                                                          | Sample Value                                                                                         |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| identifierType | Required<br />Parameter Type: Request body<br />**Data Type:** String<br />Type of identifier.<br />Valid values:<br />- "identifierType":"MDM\_IDENTIFIER"<br />- "identifierType":"GUID"                                                                                                                                                                                                           | \{<br />"identifierType":"GUID",<br />"identifiers":\["deviceGuid-1", "deviceGuid-2"]<br />}         |
| identifiers    | Required<br />Parameter Type: Request body<br />**Data Type:** String<br />List of UEM identifiers in this format:<br />\{<br />"identifierType":"MDM\_IDENTIFIER",<br />"identifiers":\["mdm-id-1", "mdm-id-2"]<br />}<br /><br />or<br />\{<br />"identifierType":"GUID",<br />"identifiers":\["deviceGuid-1", "deviceGuid-2"]<br />}<br />See [List of identifiers](docId:0FgXpF4sPOcu6M7eESvy1). | \{<br />"identifierType":"GUID",<br />"identifiers":\["dbccbe70-7499-4676-88b0-a6d5d298752e"]<br />} |

## Response fields

A list of devices.

See [List of identifiers](docId:0FgXpF4sPOcu6M7eESvy1) and [User](docId\:DK5wUaGcE74hME-EUyNkR).

## Example request

curl --location --request POST 'https\://\<Ivanti Neurons for MDM>/msa/v1/cps/device/uuid' \\

\--header 'Authorization: Basic \<token>' \\

\--header 'Content-Type: application/json' \\

\--data-raw '\{

"identifiers":\["dbccbe70-7499-4676-88b0-a6d5d298752e"]

}'

## Example response

```javascript
[
    {
        "compliant": true, 
        "quarantined": false, 
        "blocked": false, 
        "compromised": false, 
        "status": "ACTIVE", 
        "lastCheckInTime": 1581229664468, 
        "registrationTime": 1581229603492, 
        "identifier": "d0838fa7ba1ee023c9ece9192589088325d7aa08", 
        "macAddress": "8c:fe:57:b3:53:96", 
        "manufacturer": "Apple Inc.", 
        "model": "iPad7,5", 
        "os": "IOS", 
        "osVersion": "13.3", 
        "serialNumber": "GG7XP285JMVT", 
        "userId": "b2@m.com", 
        "userUuid": "b8e7fea0-4730-4bc5-a089-cfd631078b9e", 
        "iosUdid": "d0838fa7ba1ee023c9ece9192589088325d7aa08", 
        "ownership": "UNKNOWN", 
        "deviceGuid": "dbccbe70-7499-4676-88b0-a6d5d298752e"
    }
]
```