# 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

`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

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

#### Java

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;

public class Main {
  public static void main(String[] args) {

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://appdomains/dcapi/configuration/viewData/trashView"))
        .header("Accept", "application/configurationMickeyViews.v1+json")
        .header("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();
    HttpResponse<string> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());

  }
}
```

#### Python

```python
import http.client

conn = http.client.HTTPSConnection("appdomains")

headers = {
    'Accept': "application/configurationMickeyViews.v1+json",
    'Authorization': "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52"
    }

conn.request("GET", "/dcapi/configuration/viewData/trashView", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
```

#### Deluge

```javascript
headersMap = Map();
headersMap.put("Accept", "application/configurationMickeyViews.v1+json");

response = invokeUrl
[
    url: "https://appDomains/dcapi/configuration/viewData/trashView"
    type: GET
    headers: headersMap
    connection: connection_name
]

info response;
```

#### PowerShell

```powershell
$headers=@{}
$headers.Add("Accept", "application/configurationMickeyViews.v1+json")
$headers.Add("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomains/dcapi/configuration/viewData/trashView' -Method GET -Headers $headers
```

## Response Parameters

### HTTP code 200

Response Body — `application/json`

- JSON Object
  - **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 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: credentials missing, expired, or invalid.
  - **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 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

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