# 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}/dcapi/configuration/viewData/configurationsView` `{serverurl}`: [OAuth Authentication Endpoint Domain](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html) ## Scope `DesktopCentralCloud.Common.READ` ## Header `Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52` ## Request Parameters ### Request Headers - **Accept** `string` — **Mandatory** - `application/configurationMickeyViews.v1+json` ### Query Parameters - **_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 200 Response body: `application/json` - **JSON Object** - **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 400 Response body: `application/json` - **JSON Object** - **Error** `string` - Validation error — typically input-processing failure or pagination out of range. `_PN` must be `1-100000`. ### HTTP 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 500 Response body: `application/json` - **JSON Object** - **error_code** `string` - `50001`: internal server error code indicating unexpected exception in the service layer - **error_description** `string` - Internal server error. Contact administrator. ## 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" } ``` ![ ](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png) **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.