# 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.

## Endpoints

- `GET /dcapi/configuration/viewData/trashView`

## Request

### Request URL

`https://{server-hostname}:8383/dcapi/configuration/viewData/trashView`

### Scope

`Common.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Headers

- **Accept** (`string`, Mandatory): `application/configurationMickeyViews.v1+json`

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/configuration/viewData/trashView \
  --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 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 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 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"
}
```

### 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 trash 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 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.