gets the scan command status for the device
get /api/v1/mdm/devices/{device_id}/actions/scan
https://{server-hostname}:8383/api/v1/mdm/devices/{device_id}/actions/scan Copied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Unique identifier of the device. Obtain from the Get Device List response
curl --request GET \
--url https://appdomain/api/v1/mdm/devices/{device_id}/actions/scan \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Description of the last scan status
Scan status code: 0 - failed, 1 - Initiated, 2 - Success, 4 - In progress
KB article URL displayed in case of command failure
Last scan status with KB URL for troubleshooting
{
"status_description": "Command Success",
"status_code": 2,
"kb_url": "https://zylker.com/kb"
}
![]()
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.