Get devices by MDM or deviceGuid identifiers
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":"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", } |
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" } ]