Get devices by mdm or GUID identifiers

5 min

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.

{
    "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": "[email protected]", 
    "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 Parameter Type: Request body Data Type: String Type of identifier. Valid values: "identifierType":"MDM_IDENTIFIER" "identifierType":"GUID"	{ "identifierType":"GUID", "identifiers":["deviceGuid-1", "deviceGuid-2"] }
identifiers	Required Parameter Type: Request body Data Type: String List of UEM identifiers in this format: { "identifierType":"MDM_IDENTIFIER", "identifiers":["mdm-id-1", "mdm-id-2"] } or { "identifierType":"GUID", "identifiers":["deviceGuid-1", "deviceGuid-2"] } See List of identifiers.	{ "identifierType":"GUID", "identifiers":["dbccbe70-7499-4676-88b0-a6d5d298752e"] }

Response fields

A list of devices.

See List of identifiers and User.

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

[
    {
        "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": "[email protected]", 
        "userUuid": "b8e7fea0-4730-4bc5-a089-cfd631078b9e", 
        "iosUdid": "d0838fa7ba1ee023c9ece9192589088325d7aa08", 
        "ownership": "UNKNOWN", 
        "deviceGuid": "dbccbe70-7499-4676-88b0-a6d5d298752e"
    }
]