---
title: "Alert count"
source_url: https://dev.digicert.com/certcentral-apis/discovery-api/dashboard/alert-count.html
api_method: POST
api_endpoint: "/apicontroller/v1/wall/alertCount"
api_url: "https://daas.digicert.com/apicontroller/v1/wall/alertCount"
---

**POST** `https://daas.digicert.com/apicontroller/v1/wall/alertCount`

Use this endpoint to get the number of alerts displayed on the Discovery dashboard for various modules, including:

- scans
- certificates
- elapsed rotations
- duplicate keys
- endpoints
- discovered keys
- sensor upgrade

## Example requests and responses

## cURL

```bash
curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/wall/alertCount' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw ' {
	"accountId": 126993,
	"moduleName": "endPoint",
	"divisionIds": [69748, 69750, 97665, 253787, 96846, 70530, 100045, 98332, 126324,     
         69749, 303027, 94317, 124925, 553810, 531373, 376492],
	"daysToExpire": 30
}'
```

## 200 OK

```json
{
    "error": null,
    "data": 1243
}
```

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>accountId</td>
<td>required</td>
<td>string</td>
<td>Account ID.</td>
</tr>
<tr>
<td>moduleName</td>
<td>required</td>
<td>string</td>
<td>Name of module to get alert count for. See <a href="#module-table">Module table</a> below.<br><strong>Allowed values</strong>: <code>scan</code>, <code>cert</code>, <code>rotationElapsed</code>, <code>endpoint</code>, <code>duplicateKeys</code>, <code>sensor</code>, <code>isKeyDiscovered</code>, <code>sensorUpgrade</code></td>
</tr>
<tr>
<td>divisionIds</td>
<td>required</td>
<td>array</td>
<td>List of division IDs.</td>
</tr>
<tr>
<td>daysToExpire</td>
<td>conditional</td>
<td>integer</td>
<td>Number of days until certificate expiration.<br><strong>Note</strong>: If <code>moduleName</code> is <code>cert</code> or <code>endPoint</code>, your request must include either a <code>daysToExpire</code> or <code>certStatus</code> value. Use the <code>daysToExpire</code> parameter to request the number of alerts for certificates expiring in a certain number of days.</td>
</tr>
<tr>
<td>certStatus</td>
<td>conditional</td>
<td>string</td>
<td>Certificate status.<br><strong>Allowed values</strong>: <code>REVOKED</code><br><strong>Note</strong>: If <code>moduleName</code> is <code>cert</code> or <code>endPoint</code>, your request must include either a <code>daysToExpire</code> or <code>certStatus</code> value. Use the <code>certStatus</code> parameter to request the number of alerts for revoked certificates.</td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>error</td>
<td>object</td>
<td>Includes the error code, if any.</td>
</tr>
<tr>
<td>data</td>
<td>integer</td>
<td>Alert count.<br><strong>Note</strong>: When you request an alert count for the <code>isKeyDiscovered</code> module, the data response parameter returns a value of <code>0</code> (no alerts discovered) or <code>1</code> (alerts discovered).</td>
</tr>
</tbody>
</table>

## Module table

<table>
<thead>
<tr>
<th>Module name parameter</th>
<th>Friendly name in the Dashboard</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>scan</code>, <code>sensor</code>, <code>sensorUpgrade</code></td>
<td>Sensor and scan alerts</td>
</tr>
<tr>
<td><code>cert</code></td>
<td>Certificate alerts</td>
</tr>
<tr>
<td><code>endpoint</code></td>
<td>TSL/SSL server issues</td>
</tr>
<tr>
<td><code>rotationElapsed</code>, <code>duplicateKeys</code>, <code>isKeyDiscovered</code></td>
<td>Key alerts</td>
</tr>
</tbody>
</table>