gets particular device's inventory details
get /api/v1/mdm/devices/{device_id}
https://{server-hostname}:8383/api/v1/mdm/devices/{device_id}
MDMInventory.READCopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Unique identifier of the device. Obtain from the Get Device List response
Value to search for. Must be used in combination with searchfield to specify which field is searched
Name of the field to search against. Used together with searchkey (e.g., name, email, udid)
Set to true to return apps from the allow list, false to return apps from the block list
Set to true to restrict results to apps purchased through the enterprise app portal (VPP/managed Google Play). Default: false
Free-text search string applied to the default searchable fields of the resource
Filter applications by their assignment scope. Allowed values: 1=All, 2=Assigned to groups, 3=Assigned to devices
Filter results by device platform. Allowed values: 1=iOS, 2=Android, 3=Windows, 4=macOS, 6=tvOS
Token used for delta/incremental fetches. Pass the token returned from a previous response to retrieve only items modified since that point
Pagination continuation token returned by a previous response. Pass it to fetch the next page of results
Maximum number of records to return in a single response. Used together with offset for pagination
When true, returns only a lightweight summary projection of the resource instead of full details. Default: false
Include group name in the response. Allowed value: groupName. When omitted, only top-level fields are returned
curl --request GET \
--url 'https://appdomain/api/v1/mdm/devices/{device_id}?searchkey=SOME_STRING_VALUE&searchfield=SOME_STRING_VALUE&is_allowed_apps=SOME_BOOLEAN_VALUE&is_app_purchased_from_portal=SOME_BOOLEAN_VALUE&search=SOME_STRING_VALUE&app_scope=SOME_STRING_VALUE&platform=SOME_STRING_VALUE&delta-token=SOME_STRING_VALUE&skip-token=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE&summary=SOME_BOOLEAN_VALUE&include=SOME_STRING_VALUE' \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Warranty number of the device
Cellular technology type: 1 - None, 2 - GSM, 3 - CDMA
Amount of device space used (GB)
Whether the native iOS app is registered on the device
Warranty expiration date in milliseconds since epoch
Purchase order number
Device model identifier
Available free external storage space (GB)
Available free RAM in megabytes
Device ownership: 1 - Corporate, 2 - Personal
Type of warranty (e.g., WithService)
Baseband/modem firmware version
Purchase price of the device
Purchase date in milliseconds since epoch
Management status: 0 - Failed, 1 - Yet to enroll, 2 - Enrolled, 3 - Waiting approval, 4 - Unmanaged, 5 - Waiting user assignment
Network usage details for the device
Outgoing cellular network usage in bytes
Incoming Wi-Fi usage in bytes
Device identifier for the network usage record
Outgoing Wi-Fi usage in bytes
Incoming cellular network usage in bytes
Array of SIM card details
Home carrier network name
SIM Integrated Circuit Card Identifier
Whether the SIM is currently in roaming
Unique SIM identifier
Current Mobile Network Code
Subscriber (home) Mobile Network Code
Current carrier network name
Resource identifier for the SIM record
IMEI number associated with the SIM slot
Home Mobile Country Code
Current Mobile Country Code
Total external storage capacity (GB)
Samsung Knox container details
Knox container state (-1 = not applicable)
Remarks about the Knox container
Knox container status code
Last updated time of the Knox container
Samsung Knox version on the device
Owner of the device asset
APN password
Current battery level percentage
Whether the iTunes Store account is active
Whether the device is supervised (iOS)
Device serial number
Date of last cloud backup (-1 = never backed up)
Agent version code (-1 = not available)
Mobile Equipment Identifier
Whether Do Not Disturb is currently active
Office location assigned to the device
APN username
Device model name
Device registration timestamp
Purchase type (e.g., Reseller, Vendor)
Asset tag assigned to the device
Whether Activation Lock is enabled (iOS)
Available free device storage capacity (GB)
Product/manufacturer name
Agent type: 1 - iOS Profile, 2 - Android Core Agent, 3 - SAFE Agent
Whether the device locator service is enabled
Total device storage capacity (GB)
Timestamp when device was added to management
Exchange ActiveSync device identifier
Description of the device
Whether Lost Mode is enabled
Network usage details
Outgoing cellular network usage in bytes
Incoming Wi-Fi usage in bytes
Device identifier for the network usage record
Outgoing Wi-Fi usage in bytes
Incoming cellular network usage in bytes
Assigned device name
Device security details
Whether the device passcode is compliant with policy requirements
External storage encryption status (-1 = not applicable)
Whether device storage encryption is enabled
Hardware encryption capabilities (-1 = not applicable)
Whether passcode is compliant with profile requirements
Whether the device is rooted or jailbroken
Whether a passcode is set on the device
Unique Device Identifier
Summary counts for profiles, apps, documents, and groups
Number of profiles installed on the device
Number of apps on the device
Number of documents on the device
Number of groups the device belongs to
Operating system details
Platform type (e.g., android, ios, windows)
OS build version string
Operating system version
Resource identifier
Device serial number
Whether cloud backup is enabled
Model type number
Model identifier
Total RAM in megabytes
Used external storage space (GB)
Remarks about the device
Unregistered timestamp (-1 = still registered)
Comprehensive device details including hardware, network, security, and OS info
{
"warranty_number": "SJSU64728372",
"agent_version_code": "-1",
"meid": "SM-G935F",
"cellular_technology": 1,
"is_dnd_in_effect": false,
"used_device_space": "12.86491",
"is_ios_native_app_registered": false,
"office": "North Plaza,CA",
"apn_username": "zylker",
"warranty_expiration_date": 1530057600000,
"model_name": "hero2ltexx",
"registered_time": "1540655566627",
"purchase_order_number": "SR2Ik56779",
"model": "SM-G935F",
"purchase_type": "Reseller",
"available_external_capacity": "20.47",
"asset_tag": "TestDevice",
"is_activation_lock_enabled": true,
"available_device_capacity": "13.200405",
"available_ram_memory": 983,
"owned_by": "2",
"warranty_type": "WithService",
"product_name": "samsung",
"agent_type": 1,
"modem_firmware_version": "10.10.00",
"is_device_locator_enabled": true,
"purchase_price": 65000,
"purchase_date": 1527984000000,
"device_capacity": "24.81",
"managed_status": 2,
"added_time": "1523370360750",
"network_usage": {
"outgoing_network_usage": 0,
"device_id": "9007199254741001",
"incoming_wifi_usage": 0,
"outgoing_wifi_usage": 0,
"incoming_network_usage": 0
},
"eas_device_identifier": "QEGJKADSR14D1AEAA4F29FM0IC",
"sims": [
{
"subscriber_carrier_network": "--",
"iccid": 8991400912981718000,
"is_roaming": true,
"sim_id": 9508000000013204,
"current_mnc": 40,
"subscriber_mnc": 40,
"current_carrier_network": "--",
"resource_id": 9508000000013120,
"imei": 357327071694307,
"subscriber_mcc": "in",
"current_mcc": "in"
}
],
"description": "Belong to Zylker Inc",
"is_lost_mode_enabled": false,
"network": {
"outgoing_network_usage": 0,
"device_id": "9007199254741001",
"incoming_wifi_usage": 0,
"outgoing_wifi_usage": 0,
"incoming_network_usage": 0
},
"external_capacity": "29.82",
"device_name": "admin_SM-G935F",
"security": {
"passcode_complaint": false,
"external_storage_encryption": -1,
"storage_encryption": false,
"hardware_encryption_caps": -1,
"passcode_complaint_profiles": true,
"device_rooted": false,
"passcode_present": false
},
"knox_details": {
"container_state": "-1",
"knox_version": "2",
"container_status": "20004",
"container_remarks": null,
"container_last_updated_time": "-1"
},
"asset_owner": "Sysadmin",
"udid": "f8c4071d394ef48e",
"apn_password": null,
"summary": {
"doc_count": "1",
"group_count": "2",
"profile_count": "5",
"app_count": "10"
},
"battery_level": 22,
"is_itunes_account_active": true,
"os": {
"platform_type": "android",
"build_version": "NRD90M",
"os_version": "8.0.0",
"resource_id": 9508000000013120,
"serial_number": "2321bkbkqgidga1"
},
"is_cloud_backup_enabled": false,
"is_supervised": false,
"model_type": 1,
"serial_number": "2321bkbkqgidga1",
"model_id": "9007199254740997",
"last_cloud_backup_date": "-1",
"total_ram_memory": 3533,
"used_external_space": "25.38",
"remarks": "--",
"unregistered_time": -1
}
![]()
Duration: 1 minute | Threshold: 250 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.