# 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://{server-hostname}:8383/dcapi/configuration/viewData/configurationsView` ## Scope `Common.READ` ## Header `Authorization: d92d4xxxxxxxxxxxxx15f52` ## Request Parameters ### Request Headers - **Accept** (`string`, Mandatory): `application/configurationMickeyViews.v1+json` ## Sample Request ```curl curl --request GET \ --url https://appdomain/dcapi/configuration/viewData/configurationsView \ --header 'Accept: application/configurationMickeyViews.v1+json' \ --header 'Authorization: d92d4xxxxxxxxxxxxx15f52' ``` ## Response Parameters ### HTTP code 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 code 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 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 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. ## 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" } ``` ![](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.