Get scan subscription limits

less than a minute

GET https://daas.digicert.com/apicontroller/v1/scan/getScanSubscriptionLimits?&accountId=126993

Use this endpoint to obtain information about the subscription limits for a scan.

Example requests and responses

cURL

curl --location --request GET 'https://daas.digicert.com/apicontroller/v1/scan/getScanSubscriptionLimits?&accountId=126993' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw ''

200 OK

{
    "error": null,
    "data": {
        "subscriptionExpiryMessage": "valid",
        "subscriptionExpirySeverity": null,
        "subscriptionLimitMessage": "Certificate contract limit reached. Only previously configured scans will run. To enable scanning of new network segments, delete certificates or contact your account manager.",
        "subscriptionLimitSeverity": "Error"
    }
}

Response parameters

Name	Type	Description
error	object	Includes the error code if any.
data	object	Object container for response.
.. subscriptionExpiryMessage	string	Message with information about the request. Possible values: `valid` or `true`, if the subscription has not expired; `error` if the subscription has expired.
.. subscriptionExpirySeverity	string	Message with information about the request. Possible values: `warning` (approaching expiration) or `null` (account subscription is valid).
.. subscriptionLimitMessage	string	Message with additional information about the subscription limits on scan.
.. subscriptionLimitSeverity	string	Message with information about the request. Possible values: `error` if the subscription has expired.