# Retrieve all available chart types and their supported axis configurations Retrieves all available chart types and their supported axis configurations for creating chart-based custom reports. ## Endpoint **GET** `/dcapi/reports/customReports/availableCharts` ## Request ### Request URL `https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/reports/customReports/availableCharts` ### Scope `DesktopCentralCloud.CustomReport.READ` ### Header `Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52` ### Request Parameters #### Request Headers - **Accept** `string` — **Mandatory** - `application/availableCharts.v1+json` ### Sample Request ```curl curl --request GET \ --url https://appdomains/dcapi/reports/customReports/availableCharts \ --header 'Accept: application/availableCharts.v1+json' \ --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' ``` ## Response Parameters ### HTTP Code 200 Response Body — `application/json` - `JSON Object` - **availableCharts** `JSON Array` - Array of chart type objects with their axis configurations ### HTTP Code 401 Response Body — `application/json` - `JSON Object` - **errorCode** `long` - Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required) - **errorMsg** `string` - Authentication failure reason ### HTTP Code 403 Response Body — `application/json` - `JSON Object` - **errorCode** `long` - Forbidden error code returned when the authenticated user does not have the required uem-roles (e.g., DataEncryption_Admin or DataEncryptionRecoveryKey_Admin) - **errorMsg** `string` - Message indicating insufficient privileges to access this resource ### HTTP Code 417 Response Body — `application/json` - `JSON Object` - **errorCode** `string` - Expectation failed error code: Custom Report V2 is not enabled - **errorMessage** `string` - Message indicating Custom Report V2 feature is not active ### HTTP Code 429 Response Body — `application/json` - `JSON Object` - **errorCode** `long` - Rate limit error code returned when the API call threshold (configured via threshold/duration in security XML) is exceeded; client is locked out for lock-period minutes - **errorMsg** `string` - Rate limit exceeded message with retry guidance ## Possible Response Codes - **200** — HTTP code - **401** — HTTP code - **403** — HTTP code - **417** — HTTP code - **429** — HTTP code ## Sample Responses ### HTTP 200 All available chart types with axis configurations ```json { "availableCharts": [ { "displayName": "Bar Chart", "axisSupported": [ "xAxis", "yAxis" ], "chartType": "bar" }, { "displayName": "Line Chart", "axisSupported": [ "xAxis", "yAxis" ], "chartType": "line" }, { "displayName": "Area Chart", "axisSupported": [ "xAxis", "yAxis" ], "chartType": "area" }, { "displayName": "Pie Chart", "axisSupported": [ "xAxis", "yAxis" ], "chartType": "pie" }, { "displayName": "Dial Chart", "axisSupported": [ "xAxis", "yAxis" ], "chartType": "dial" }, { "displayName": "Pyramid Chart", "axisSupported": [ "xAxis", "yAxis" ], "chartType": "pyramid" }, { "displayName": "Funnel Chart", "axisSupported": [ "xAxis", "yAxis" ], "chartType": "funnel" } ] } ``` ### HTTP 401 Missing or invalid authentication token ```json { "errorMessage": "Authentication token is missing or invalid", "errorCode": "401" } ``` ### HTTP 403 User does not have the required role ```json { "errorMessage": "User does not have the required role to access this resource", "errorCode": "403" } ``` ### HTTP 417 Custom Report V2 is not enabled ```json { "errorMessage": "Custom Report V2 is not enabled", "errorCode": "417" } ``` ### HTTP 429 Rate limit exceeded ```json { "errorMessage": "Rate limit exceeded. Please retry after some time", "errorCode": "429" } ``` ## Rate Limiting **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.