Returns the device/file audit configuration for a specific customer.
get /dcapi/device/auditsettings/{customerID}
https://{serverurl}/dcapi/device/auditsettings/{customerID}
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Customer identifier for audit settings
curl --request GET \
--url https://appdomains/dcapi/device/auditsettings/{customerID} \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json'Audit settings configuration
Customer identifier
Whether device audit reporting is enabled
Number of days to retain device audit data
Whether file audit reporting is enabled
Number of days to retain file audit data
Whether file shadow reporting is enabled
Number of days to retain file shadow report data
Mail template content for audit notifications
Whether archiving is enabled
Number of days to retain archived files
File system path for archived files
File operation type IDs being audited
Device type IDs being audited
Error code identifying the type of error
Human-readable error message
Audit settings response
{
"auditsetting": {
"fileShadowReportEnabled": true,
"deviceReportEnabled": true,
"fileReportEnabled": true,
"daysToRetainFileShadowReport": 60,
"daysToRetainDevice": 120,
"archieveEnabled": true,
"mailTemplate": "",
"selectedDeviceTypes": [
"1",
"2",
"3"
],
"fileOperations": [
1,
2,
3,
4
],
"daysToRetainArchivedFiles": 60,
"customerID": "1",
"daysToRetainFile": 90,
"archievePath": "C:\\Archive"
}
}
Internal server error
{
"errorCode": "INTERNAL_ERROR",
"errorMsg": "Internal Server Error!"
}
![]()
Duration: 1 minute | Threshold: 30 | 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.