Retrieve a list of managed devices

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

gets list of devices and its details

Endpoints

Request URL

https://{serverurl}/api/v1/mdm/devices

Scope

MDMOnDemand.MDMInventory.READCopied!

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Query Parameters

limitintegerOptional

Maximum number of records to return in a single response. Used together with offset for pagination

skip-tokenstringOptional

Pagination continuation token returned by a previous response. Pass it to fetch the next page of results

offsetintegerOptional

Zero-based index of the first record to return. Used together with limit for pagination

delta-tokenstringOptional

Token used for delta/incremental fetches. Pass the token returned from a previous response to retrieve only items modified since that point

searchkeystringOptional

Value to search for. Must be used in combination with searchfield to specify which field is searched

searchfieldstringOptional

Name of the field to search against. Used together with searchkey (e.g., name, email, udid)

is_allowed_appsbooleanOptional

Set to true to return apps from the allow list, false to return apps from the block list

is_app_purchased_from_portalbooleanOptional

Set to true to restrict results to apps purchased through the enterprise app portal (VPP/managed Google Play). Default: false

searchstringOptional

Free-text search string applied to the default searchable fields of the resource

app_scopestringOptional

Filter applications by their assignment scope. Allowed values: 1=All, 2=Assigned to groups, 3=Assigned to devices

platformstringOptional

Filter results by device platform. Allowed values: 1=iOS, 2=Android, 3=Windows, 4=macOS, 6=tvOS

emailstringOptional
group_idlongOptional
exclude_removedbooleanOptional
owned_byintegerOptional
device_typestringOptional

Filter results by device type. Allowed values: 1=Mobile, 2=Tablet, 3=Laptop, 4=Desktop, 5=TV

select_allbooleanOptional

When true, applies the operation to every record matching the current filter rather than to specific IDs. Default: false

device_group_unassignedbooleanOptional

When true, returns only devices that are not assigned to any device group. Default: false

summarybooleanOptional

When true, returns only a lightweight summary projection of the resource instead of full details. Default: false

imeistringOptional
include_allbooleanOptional
serial_numberstringOptional
customer_idsstringOptional
is_tree_sourcebooleanOptional
exclude_agentstringOptional
is_supervisedbooleanOptional
start_datestringOptional
end_datestringOptional

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomain/api/v1/mdm/devices \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
Show full

Response Parameters

- HTTP code 200

Response Body - application/json

JSON object
Hide Sub-Attributes
devicesJSON array

Array of managed device objects

Show Sub-Attributes
JSON object
Show Sub-Attributes
device_idstring

Unique identifier of the managed device

os_versionstring

Operating system version installed on the device

is_lost_mode_enabledboolean

Whether Lost Mode is currently enabled on the device

owned_bystring

Device ownership type: 1 - Corporate, 2 - Personal

is_removedstring

(Deprecated) Whether the device is removed from management

product_namestring

Manufacturer or product name of the device

device_namestring

Assigned name of the device

platform_typestring

Platform type of the device (e.g., android, ios, windows)

platform_type_idstring

Platform type ID: 1 - iOS, 2 - Android, 3 - Windows

udidstring

Unique Device Identifier

serial_numberstring

Hardware serial number of the device

modelstring

Device model identifier

userJSON object

User details assigned to the device

Show Sub-Attributes
user_namestring

Name of the user assigned to the device

user_idstring

Unique identifier of the assigned user

user_emailstring

Email address of the assigned user

imeilong

International Mobile Equipment Identity number

summaryJSON object

Summary counts of profiles, apps, documents, and groups

Show Sub-Attributes
profile_countstring

Number of profiles installed on the device

app_countstring

Number of apps on the device

doc_countstring

Number of documents on the device

group_countstring

Number of groups the device belongs to

Possible HTTP Status Codes

200HTTP code

Sample Response: HTTP 200

List of managed devices with user and summary details

Copied!
  {
    "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"
        }
      }
    ]
  }
                
Show full

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.