# Retrieve the paginated list of configurations with search, sort and filter options Returns a paginated list of all configurations visible to the requesting user. Supports pagination (`_PN`), search (`SEARCH_COLUMN` / `SEARCH_VALUE`) and view-specific filters by platform, status, type and config category. ## Endpoint `GET /dcapi/configuration/viewData/configurationsView` ## Request URL `https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/configuration/viewData/configurationsView` ## Scope `DesktopCentralCloud.Common.READ` ## Header `Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52` ## Request Parameters ### Request Headers | Parameter | Type | Required | Value | |---|---|---|---| | Accept | string | Mandatory | `application/configurationMickeyViews.v1+json` | ### Query Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `_PN` | string | Optional | Page number to fetch (1-based). Defaults to 1. | | `SEARCH_COLUMN` | string | Optional | Column alias on which the search should be applied. Searches against the configuration name (`Collection.COLLECTION_NAME`). Must be supplied together with `SEARCH_VALUE`. | | `SEARCH_VALUE` | string | Optional | Substring to search for within the configuration name. Case-insensitive. | | `platFormID` | string | Optional | Filter by target OS platform. `1` = Windows, `2` = Mac, `3` = Linux. | | `configurationStatus` | string | Optional | Filter by configuration status. Common values: deployed, suspended, draft, trashed, yetToDeploy, expired. | | `configurationType` | string | Optional | Filter by target type. `1` = User configuration, `2` = Computer configuration. | | `category` | long | Optional | Filter by configuration-type ID (config-id). The ID identifies the specific configuration category — for example `121` = Custom Script. | ## Sample Request ```curl curl --request GET \ --url https://appdomains/dcapi/configuration/viewData/configurationsView \ --header 'Accept: application/configurationMickeyViews.v1+json' \ --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' ``` ## Response Parameters ### HTTP Code 200 Response body: `application/json` | Parameter | Type | Description | |---|---|---| | status | string | Result of the view-data fetch — `'success'` on success, `'failure'` on internal error. | | messageResponse | JSON Array | Array of configuration row objects matching the applied filters/search/sort, paginated by `_PN`. | | metadata | JSON Object | Pagination metadata for the response. | | totalRecords | string | Total number of configurations matching the applied filters across all pages. | | totalPages | string | Total number of pages available based on the page limit. | | Links | JSON Object | Hypermedia navigation links for first / previous / next / last pages. | ### HTTP Code 400 Response body: `application/json` | Parameter | Type | Description | |---|---|---| | Error | string | Validation error — typically input-processing failure or pagination out of range. `_PN` must be `1-100000`. | ### HTTP Code 401 Response body: `application/json` | Parameter | Type | Description | |---|---|---| | errorCode | long | Unauthorized error code: credentials missing, expired, or invalid. | | errorMsg | string | Authentication failure reason. | ### HTTP Code 500 Response body: `application/json` | Parameter | Type | Description | |---|---|---| | error_code | string | `50001`: internal server error code indicating unexpected exception in the service layer. | | error_description | string | Internal server error. Contact administrator. | ## Possible Response Codes - `200` — HTTP code - `400` — HTTP code - `401` — HTTP code - `500` — HTTP code ## Sample Response: HTTP 200 ### First page sorted by last-modified time (default) ```json { "metadata": { "limit": 25, "page": 1 }, "totalRecords": 1, "messageResponse": [ { "total_target_count": null, "collection_creation_time_transform": "Apr 27, 2026 02:36 PM", "modifieduser_user_id": "9502000000121919", "status_count_desc_transform": "--", "collection_collection_id": "9502000000143001", "dcuserscollectionmapping_collection_id": "9502000000143001", "total_target_count_transform": "--", "os_platform_name": "Windows", "retry_inprogress_count_transform": "--", "status_id": "9", "collection_modified_time": "1777280770860", "config_data_id": "9502000000143003", "config_type_transform": "1", "config_type": "1", "statuslabel_transform": "Draft", "os_platform_id": "1", "os_platform_name_transform": "Windows", "is_collection_deleted": "false", "modifieduser_first_name": "testuser1", "deletedby": null, "collection_collection_id_transform": "9502000000143001", "success_count_transform": "--", "label_transform": "dc.common.SCHEDULER", "retry_inprogress_count": null, "config_id": "128", "user_id": "9502000000121919", "small_image_name": "images/scheduler.gif", "yet_to_apply_count_transform": "--", "deleted_time": null, "collection_name": "MyConfiguration48", "dc_user_id": null, "show_in_view": "true", "collection_name_transform": "MyConfiguration48", "statusimage": "images/draft.gif", "collection_platform_id": "1", "statuslabel": "dc.db.config.status.draft", "collection_id": "9502000000143001", "first_name_transform": "testuser1", "cfgdatatocollection_collection_id": "9502000000143001", "collection_status": "9", "not_applicable_count": null, "not_applicable_count_transform": "--", "first_name": "testuser1", "failed_count_transform": "--", "collection_creation_time": "1777280770860", "is_single_config": "true", "modifieduser_first_name_transform": "testuser1", "collection_modified_time_transform": "Apr 27, 2026 02:36 PM", "success_count": null, "label": "dc.common.SCHEDULER", "status_count_desc": null, "yet_to_apply_count": null, "failed_count": null, "customer_id": "9502000000121939", "created_from": null } ], "totalPages": 1, "Links": { "last": "/dcapi/configuration/viewData/configurationsView?_PN=1", "first": "/dcapi/configuration/viewData/configurationsView?_PN=1" }, "status": "success" } ``` ### Filtered by category=121 (Custom Script) and platFormID=1 (Windows), sorted by name ascending ```json { "metadata": { "limit": 25, "page": 1 }, "totalRecords": 1, "messageResponse": [ { "total_target_count": 1, "collection_creation_time_transform": "Apr 15, 2026 05:25 PM", "modifieduser_user_id": "9502000000121919", "status_count_desc_transform": "Success: 1", "collection_collection_id": "9502000000143501", "dcuserscollectionmapping_collection_id": "9502000000143501", "total_target_count_transform": "1", "os_platform_name": "Windows", "retry_inprogress_count_transform": "0", "status_id": "1", "collection_modified_time": "1776200770860", "config_data_id": "9502000000143503", "config_type_transform": "2", "config_type": "2", "statuslabel_transform": "Deployed", "os_platform_id": "1", "os_platform_name_transform": "Windows", "is_collection_deleted": "false", "modifieduser_first_name": "admin", "deletedby": null, "collection_collection_id_transform": "9502000000143501", "success_count_transform": "1", "label_transform": "Custom Script", "retry_inprogress_count": 0, "config_id": "121", "user_id": "9502000000121919", "small_image_name": "images/customscript.gif", "yet_to_apply_count_transform": "0", "deleted_time": null, "collection_name": "MyConfiguration12", "dc_user_id": null, "show_in_view": "true", "collection_name_transform": "MyConfiguration12", "statusimage": "images/deployed.gif", "collection_platform_id": "1", "statuslabel": "dc.db.config.status.deployed", "collection_id": "9502000000143501", "first_name_transform": "admin", "cfgdatatocollection_collection_id": "9502000000143501", "collection_status": "1", "not_applicable_count": 0, "not_applicable_count_transform": "0", "first_name": "admin", "failed_count_transform": "0", "collection_creation_time": "1776200770860", "is_single_config": "true", "modifieduser_first_name_transform": "admin", "collection_modified_time_transform": "Apr 15, 2026 05:25 PM", "success_count": 1, "label": "dc.common.CUSTOM_SCRIPT", "status_count_desc": "Success: 1", "yet_to_apply_count": 0, "failed_count": 0, "customer_id": "9502000000121939", "created_from": null } ], "totalPages": 1, "Links": { "last": "/dcapi/configuration/viewData/configurationsView?_PN=1&category=121&platFormID=1", "first": "/dcapi/configuration/viewData/configurationsView?_PN=1&category=121&platFormID=1" }, "status": "success" } ``` ### No configurations match the applied filters ```json { "metadata": { "limit": 25, "page": 1 }, "totalRecords": 0, "messageResponse": [], "totalPages": 0, "Links": { "last": "/dcapi/configuration/viewData/configurationsView?_PN=1", "first": "/dcapi/configuration/viewData/configurationsView?_PN=1" }, "status": "success" } ``` ## Sample Response: HTTP 400 ### `_PN` outside the allowed range ```json { "Error": "PageNumber should not be greater than 100000 " } ``` ### Failure while parsing the query parameters ```json { "Error": "Error in Input Processing" } ``` ## Sample Response: HTTP 401 ### User lacks the required read role for the configurations view ```json { "error_description": "Access denied - You are not allowed to access the requested resource.", "error_code": "UAC_UNAUTHORIZED" } ``` ## Sample Response: HTTP 500 ### Unexpected failure while resolving the view data ```json { "error_description": "Internal server error. Contact administrator.", "error_code": "50001" } ``` ## Rate Limit **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.