Integrations
Kandji
APIs
Get Device Details

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 NameDescriptionRequired
Device ID device_idThe ID of the device.Yes

Returns

A JSON object.

Required Secrets

Secret PlaceholderDescription
KANDJI_SECRETKandji 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"]
}