# 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}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/dcapi/configuration/trashCount`

## Scope

`DesktopCentralCloud.Configurations.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

| Parameter | Type | Requirement | Value |
|---|---|---|---|
| Accept | string | Mandatory | `application/configTrashCount.v1+json` |

### Query Parameters

| Parameter | Type | Requirement | Description |
|---|---|---|---|
| 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`

| Attribute | Type | Description |
|---|---|---|
| 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`

| Attribute | Type | Description |
|---|---|---|
| errorCode | long | Unauthorized error code: credentials missing, expired, or invalid |
| errorMsg | string | Authentication failure reason |

### HTTP Code 500

Response Body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| 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

| HTTP Code |
|---|
| 200 |
| 401 |
| 500 |

## Sample Response: HTTP 200

### Trash count across all modules

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

### No items in trash

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

## Sample Response: HTTP 401

### User lacks required roles

```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 calculating trash count

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

## Rate Limits

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