# Retrieve the paginated list of trashed configurations with search, sort and filter options

Returns a paginated list of all configurations that have been moved to trash for the requesting user. Supports pagination (`_PN`) and search (`SEARCH_COLUMN` / `SEARCH_VALUE`). Each row includes the deleted-by user, deleted time and the collectionId, which can be used in the trash restore / permanent delete APIs.

## Endpoint

`GET /dcapi/configuration/viewData/trashView`

## Request

### Request URL

https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/configuration/viewData/trashView

### Scope

`DesktopCentralCloud.Common.READ`

### Header

```text
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.

### Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/configuration/viewData/trashView \
  --header 'Accept: application/configurationMickeyViews.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP 200

Response body: `application/json`

- `status` `string`
  - Result of the trash-view fetch — `'success'` on success, `'failure'` on internal error.
- `messageResponse` `JSON Array`
  - Array of trashed configuration row objects matching the applied search/sort, paginated by `_PN`.
- `metadata` `JSON Object`
  - Pagination metadata for the response.
- `totalRecords` `string`
  - Total number of trashed 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`

- `Error` `string`
  - Validation error — typically input-processing failure or pagination out of range. `_PN` must be 1-100000.

### HTTP 401

Response body: `application/json`

- `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`

- `error_code` `string`
  - `50001`: internal server error code indicating unexpected exception in the service layer
- `error_description` `string`
  - Internal server error. Contact administrator.

## Sample Responses

### HTTP 200

First page of trashed configurations sorted by last-modified time descending (default):

```json
{
  "metadata": {
    "limit": 25,
    "page": 1
  },
  "totalRecords": 1,
  "messageResponse": [
    {
      "total_target_count": "1",
      "modifieduser_user_id": "9502000000121919",
      "status_count_desc_transform": "Total Targets ( 1 ), Success ( 1 )",
      "collection_collection_id": "9502000000139889",
      "dcuserscollectionmapping_collection_id": "9502000000139889",
      "total_target_count_transform": "1",
      "os_platform_name": "Windows",
      "retry_inprogress_count_transform": "0",
      "status_id": "4",
      "collection_modified_time": "1777353655231",
      "config_data_id": "9502000000139891",
      "deletedby_transform": "testuser1",
      "config_type": "1",
      "statuslabel_transform": "Executed",
      "os_platform_id": "1",
      "os_platform_name_transform": "Windows",
      "is_collection_deleted": "true",
      "modifieduser_first_name": "testuser1",
      "deletedby": "testuser1",
      "collection_collection_id_transform": "9502000000139919",
      "success_count_transform": "1",
      "label_transform": "dc.conf.conf_param.Message_Box",
      "retry_inprogress_count": "0",
      "config_id": "117",
      "user_id": "9502000000121919",
      "small_image_name": "images/alert.png",
      "yet_to_apply_count_transform": "0",
      "deleted_time": "1777353655231",
      "collection_name": "MyConfiguration20",
      "dc_user_id": "9502000000121919",
      "show_in_view": "true",
      "collection_name_transform": "MyConfiguration21",
      "statusimage": "images/config_status_executed.png",
      "collection_platform_id": "1",
      "statuslabel": "dc.db.config.status.executed",
      "collection_id": "9502000000139889",
      "first_name_transform": "testuser1",
      "cfgdatatocollection_collection_id": "9502000000139889",
      "collection_status": "4",
      "deleted_time_transform": "Apr 28, 2026 10:50 AM",
      "not_applicable_count": "0",
      "not_applicable_count_transform": "0",
      "first_name": "testuser1",
      "failed_count_transform": "0",
      "collection_creation_time": "1776757701089",
      "is_single_config": "true",
      "collection_modified_time_transform": "Apr 28, 2026 10:50 AM",
      "success_count": "1",
      "label": "dc.conf.conf_param.Message_Box",
      "status_count_desc": "Total Targets ( 1 ), Success ( 1 )",
      "yet_to_apply_count": "0",
      "failed_count": "0",
      "customer_id": "9502000000121939",
      "created_from": null
    }
  ],
  "totalPages": 1,
  "Links": {
    "last": "/dcapi/configuration/viewData/trashView?_PN=1",
    "first": "/dcapi/configuration/viewData/trashView?_PN=1"
  },
  "status": "success"
}
```

No configurations are currently in the trash:

```json
{
  "metadata": {
    "limit": 25,
    "page": 1
  },
  "totalRecords": 0,
  "messageResponse": [],
  "totalPages": 0,
  "Links": {
    "last": "/dcapi/configuration/viewData/trashView?_PN=1",
    "first": "/dcapi/configuration/viewData/trashView?_PN=1"
  },
  "status": "success"
}
```

### 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"
}
```

### HTTP 401

User lacks the required read role for the trash view:

```json
{
  "error_description": "Access denied - You are not allowed to access the requested resource.",
  "error_code": "UAC_UNAUTHORIZED"
}
```

### HTTP 500

Unexpected failure while resolving the trash view data:

```json
{
  "error_description": "Internal server error. Contact administrator.",
  "error_code": "50001"
}
```

## Rate Limit

![](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.