gets list of devices and its details
https://{serverurl}/api/v1/mdm/devices
MDMOnDemand.MDMInventory.READCopied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Maximum number of records to return in a single response. Used together with offset for pagination
Pagination continuation token returned by a previous response. Pass it to fetch the next page of results
Zero-based index of the first record to return. Used together with limit for pagination
Token used for delta/incremental fetches. Pass the token returned from a previous response to retrieve only items modified since that point
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
Filter results by device type. Allowed values: 1=Mobile, 2=Tablet, 3=Laptop, 4=Desktop, 5=TV
When true, applies the operation to every record matching the current filter rather than to specific IDs. Default: false
When true, returns only devices that are not assigned to any device group. Default: false
When true, returns only a lightweight summary projection of the resource instead of full details. Default: false
curl --request GET \
--url https://appdomain/api/v1/mdm/devices \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Array of managed device objects
Unique identifier of the managed device
Operating system version installed on the device
Whether Lost Mode is currently enabled on the device
Device ownership type: 1 - Corporate, 2 - Personal
(Deprecated) Whether the device is removed from management
Manufacturer or product name of the device
Assigned name of the device
Platform type of the device (e.g., android, ios, windows)
Platform type ID: 1 - iOS, 2 - Android, 3 - Windows
Unique Device Identifier
Hardware serial number of the device
Device model identifier
User details assigned to the device
Name of the user assigned to the device
Unique identifier of the assigned user
Email address of the assigned user
International Mobile Equipment Identity number
Summary counts of 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
List of managed devices with user and summary details
{
"devices": [
{
"summary": {
"doc_count": "1",
"group_count": "2",
"profile_count": "5",
"app_count": "10"
},
"device_id": "9007199254741001",
"os_version": "8.0.0",
"is_lost_mode_enabled": false,
"owned_by": "2",
"is_removed": "false",
"serial_number": "2321bkbkqgidga1",
"product_name": "samsung",
"device_name": "admin_SM-G935F",
"platform_type": "android",
"imei": 357327071694307,
"model": "SM-G935F",
"udid": "f8c4071d394ef48e",
"platform_type_id": "2",
"user": {
"user_email": "admin@zylker.com",
"user_id": "9007199254740999",
"user_name": "admin"
}
}
]
}
![]()
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.