Get Device Details
Get details for a Kandji managed device.
For more information on the API, see Get Device Details (opens in a new tab).
Required permissions:
Device details
SDK Import:
from admyral.actions import get_kandji_device_details
Arguments:
Argument Name | Description | Required |
---|---|---|
Device ID device_id | The ID of the device. | Yes |
Returns
A JSON object.
Required Secrets
Secret Placeholder | Description |
---|---|
KANDJI_SECRET | Kandji secret. See Kandji setup |
SDK Example
device_details = get_kandji_device_details(
device_id="03f81208-2b6a-4a77-81f5-cf1633bcfb95",
secrets={"KANDJI_SECRET": "my_kandji_secret"}
)
Example Output:
{
"general": {
"device_id": "03f81208-2b6a-4a77-81f5-cf1633bcfb95",
"device_name": "testuser’s MacBook Air",
"last_enrollment": "2024-05-13 20:09:27.374451+00:00",
"first_enrollment": "2024-01-26 16:15:36.087016+00:00",
"model": "MacBook Air (M1, 2020)",
"platform": "Mac",
"os_version": "14.4.1",
"supplemental_build_version": "23E224",
"supplemental_os_version_extra": "",
"system_version": "14.4.1 (23E224)",
"boot_volume": "Macintosh HD",
"time_since_boot": "1 month ago",
"last_user": "root",
"asset_tag": "sending_tag_to_now",
"assigned_user": {
"email": "accuhive.admin@kandji.io",
"name": "acchuhive admin",
"id": "5344c996-8823-4b37-8d6e-8515fc7c3a0a",
"is_archived": false
},
"blueprint_name": "_test_something",
"blueprint_uuid": "ab102b9d-8e9c-420d-a498-f2a1123091c7"
},
"mdm": {
"mdm_enabled": "True",
"supervised": "True",
"install_date": "2024-05-13 20:09:27.213607+00:00",
"last_check_in": "2024-07-23 12:43:15.675470+00:00",
"mdm_enabled_user": ["testuser"]
},
"activation_lock": {
"bypass_code_failed": false,
"user_activation_lock_enabled": false,
"device_activation_lock_enabled": false,
"activation_lock_allowed_while_supervised": false,
"activation_lock_supported": true
},
"filevault": {
"filevault_enabled": false,
"filevault_recoverykey_type": "",
"filevault_prk_escrowed": false,
"filevault_next_rotation": "",
"filevault_regen_required": false
},
"lost_mode": {},
"automated_device_enrollment": {},
"kandji_agent": {
"agent_installed": "True",
"install_date": "2024-06-17 11:32:35+00:00",
"last_check_in": "2024-07-23T14:26:49.166267Z",
"agent_version": "4.5.9 (5160)"
},
"hardware_overview": {
"model_name": "MacBook Air",
"model_identifier": "MacBookAir10,1",
"processor_name": "Apple M1",
"processor_speed": "",
"number_of_processors": "8",
"total_number_of_cores": "8",
"memory": "8 GB LPDDR4",
"udid": "3c976d96-08a0-5014-89e4-66259ab79fe6",
"serial_number": "FVHHFKF7Q6L4"
},
"volumes": [
{
"name": "Macintosh HD",
"format": "APFS",
"percent_used": "19%",
"identifier": "disk3s3s1",
"capacity": "228.27 GB",
"available": "182.66 GB",
"encrypted": "No"
},
{
"name": "Macintosh HD - Data",
"format": "APFS",
"percent_used": "19%",
"identifier": "disk3s1",
"capacity": "228.27 GB",
"available": "182.66 GB",
"encrypted": "Yes"
}
],
"network": {
"local_hostname": "testusers-MacBook-Air",
"mac_address": "fc:e2:6c:27:1b:e4",
"ip_address": "192.168.1.76",
"public_ip": ""
},
"recovery_information": {
"recovery_lock_enabled": true,
"firmware_password_exist": false,
"firmware_password_pending": false,
"password_rotation_scheduled": "2024-09-10T11:48:00.610908Z",
"password_has_been_set": true
},
"users": {
"regular_users": [
{
"username": "testuser",
"uid": "501",
"path": "/Users/testuser",
"admin": "Yes",
"name": ""
}
],
"system_users": [
{
"username": "_lp",
"uid": "26",
"path": "/var/spool/cups",
"admin": "No"
},
{
"username": "_ard",
"uid": "67",
"path": "/var/empty",
"admin": "No"
}
]
},
"installed_profiles": [
{
"name": "MDM Profile",
"uuid": "35fec4f0-88f4-41c5-b3c1-e6da3f0f592d",
"verified": "verified",
"identifier": "com.kandji.profile.mdmprofile",
"organization": "Kandji, Inc.",
"payload_types": ["com.apple.mdm", "com.apple.security.scep"],
"install_date": "2024-05-13 20:09:23 +0000"
},
{
"name": "SCEP for Okta Device Trust",
"uuid": "351c9f76-defa-5fbe-91d3-c9aefe787453",
"verified": "verified",
"identifier": "com.kandji.profile.odt.scep",
"organization": "Kandji, Inc.",
"payload_types": ["com.apple.security.scep"],
"install_date": "2024-06-14 00:24:43 +0000"
},
{
"name": "SSO for Okta Device Trust",
"uuid": "3e350947-74f1-5d73-bb70-abb7ea9af6c1",
"verified": "verified",
"identifier": "com.kandji.profile.odt.sso",
"organization": "Kandji, Inc.",
"payload_types": [
"com.apple.extensiblesso",
"com.apple.loginitems.managed",
"com.okta.mobile",
"com.okta.mobile.auth-service-extension"
],
"install_date": "2024-06-11 23:15:57 +0000"
},
{
"name": "Kandji Agent Settings",
"uuid": "1cbbbb6e-f8cc-41d7-bd1c-aa83b962a915",
"verified": "verified",
"identifier": "com.kandji.profile.pppc",
"organization": "Kandji, Inc.",
"payload_types": [
"com.apple.TCC.configuration-profile-policy",
"com.apple.TCC.configuration-profile-policy",
"com.apple.notificationsettings",
"com.apple.servicemanagement",
"com.apple.system-extension-policy",
"io.kandji.extensions"
],
"install_date": "2024-05-13 22:07:50 +0000"
}
],
"apple_business_manager": {},
"security_information": {
"remote_desktop_enabled": true
},
"cellular": {},
"tags": ["accuhive_02"]
}