This API lists all query reports along with their metadata such as Report ID, Label, Owner, View name, Description, and Last modified time.
get /dcapi/reports/queryReports
https://{server-hostname}:8383/dcapi/reports/queryReports
QueryReport.READCopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
curl --request GET \
--url https://appdomain/dcapi/reports/queryReports \
--header 'Accept: application/allQueryReports.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Parent node identifier. Always null for the root node
Array of child query-report nodes. Each element represents one saved query report. Null when no reports exist
Parent node identifier. Always queryReports for child report nodes
Always null for leaf nodes. Individual query reports have no children
Whether this node is the root. Always false for child report nodes
Unique report ID (CRSAVEVIEW_ID) identifying this saved query report
Display name of the saved query report as set by the report creator
Whether this node is a leaf. Always true for individual query reports
Additional metadata for the report including owner, view name, description, and last modified timestamp
First name of the user who created the query report
Internal view/query name stored in the database (CRVIEWNAME)
Whether the node can be expanded. Always false for individual query reports
Whether the node can be selected. Always true for individual query reports
User-provided description of the query report
Last modified timestamp formatted per the authenticated user's time-format preference. Example: Sep 3, 2024 01:05 PM
Whether this node is the root of the tree. Always true for the top-level response node
Unique identifier for this node. Always queryReports for the root node
Localised display name for this node. Example: Query Reports
Whether this node is a leaf (has no children). False when children exist, true when children is null
Additional metadata for the root node including report type and expandable/selectable flags
Report type identifier. Value 3 indicates Query Reports
Whether the node can be expanded in the UI tree. True when child reports exist, false otherwise
Whether the node can be selected in the UI tree. True when child reports exist, false otherwise
Error code for unauthorized MSP access. REPORT_UNAUTHORIZED = MSP non-admin user attempting to list query reports
Human-readable message indicating the user is not authorized as an MSP admin to access query reports
Error code for server-side failure. INTERNAL_ERROR = an unexpected error occurred while fetching the list of query reports (e.g., database exception)
Human-readable message describing the internal server error encountered while retrieving available query reports
Root node with one saved query report as a child
{
"parent": null,
"children": [
{
"parent": "queryReports",
"children": null,
"root": false,
"id": "1",
"label": "sample",
"leaf": true,
"properties": {
"owner": "user",
"viewName": "SAMPLE",
"expandable": false,
"selectable": true,
"description": "Test Description",
"lastModified": "Sep 3, 2024 01:05 PM"
}
}
],
"root": true,
"id": "queryReports",
"label": "Query Reports",
"leaf": false,
"properties": {
"reportType": "3",
"expandable": true,
"selectable": true
}
}
Root node with no saved query reports — children is null and expandable/selectable are false
{
"parent": null,
"children": null,
"root": true,
"id": "queryReports",
"label": "Query Reports",
"leaf": true,
"properties": {
"reportType": "3",
"expandable": false,
"selectable": false
}
}
MSP non-admin user attempting to list query reports
{
"errorMessage": "You are not authorized to access this resource",
"errorCode": "REPORT_UNAUTHORIZED"
}
Unexpected error while fetching available query reports from the database
{
"errorMessage": "An internal server error occurred while retrieving query reports",
"errorCode": "INTERNAL_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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.