Skip to main content

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

Example requests and responses

Example 1. 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
}'

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

In this section: