Get devices by UEM or deviceGuid identifiers
This API returns the details of devices with the UEM or deviceGuid identifiers specified in the request body. It silently ignores invalid UEM and deviceGuid identifiers. In the following device details resturn, the UEM 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 xxxxxdXNlckBtb2JpbGVpcm9uLmNvbTpNaTRtYW4xMQ==' \
--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"
}
]