# Retrieve the count of configurations currently in trash

Retrieves the total count of configurations currently in the trash for the requesting user. Supports optional filters for Software Deployment, Patch Management, or Vulnerability Management modules.

## Endpoint

`GET /dcapi/configuration/trashCount`

## Request URL

`https://{serverurl}/dcapi/configuration/trashCount`

`{serverurl}`: [OAuth Authentication Endpoint Domain](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)

## Scope

`DesktopCentralCloud.Configurations.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` — **Mandatory**
  - `application/configTrashCount.v1+json`

### Query Parameters

- **SW_TAB** `boolean` — Optional
  - When true, includes Software Deployment configurations in the trash count.
- **Patch** `boolean` — Optional
  - When true, includes Patch Management configurations in the trash count.
- **VMP_TAB** `boolean` — Optional
  - When true, includes Vulnerability Management configurations in the trash count.

## Sample Request

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

## Response Parameters

### HTTP Code 200

Response body: `application/json`

- `JSON Object`
  - **trashCount** `string`
    - Total count of configurations currently in trash that match the specified filter criteria and are accessible to the requesting user.

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

## Sample Responses

### HTTP 200

#### Trash count across all modules

```json
{
  "trashCount": 15
}
```

#### No items in trash

```json
{
  "trashCount": 0
}
```

### HTTP 401

#### User lacks required roles

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

### HTTP 500

#### Unexpected failure while calculating trash count

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