# 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

### Request URL

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

### Scope

`Configurations.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** (string, mandatory): `application/configTrashCount.v1+json`

## Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/configuration/trashCount \
  --header 'Accept: application/configTrashCount.v1+json' \
  --header 'Authorization:  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.

### Possible Response Codes

- **200** — HTTP code
- **401** — HTTP code
- **500** — HTTP code

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