Alert count

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
cURL
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
{
    "error": null,
    "data": 1243
}

Request parameters

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

Response parameters

Name Type Description
error object Includes the error code, if any.
data integer Alert count.
NOTE: When you request an alert count for the isKeyDiscovered module, the data response parameter returns a value of 0 (no alerts discovered) or 1 (alerts discovered).

Module table

Module name parameter Friendly name in the Dashboard
scan, sensor, sensorUpgrade Sensor and scan alerts
cert Certificate alerts
endpoint TSL/SSL server issues
rotationElapsed, duplicateKeys, isKeyDiscovered Key alerts