---
title: "Get scan subscription limits"
source_url: https://dev.digicert.com/certcentral-apis/discovery-api/scan-activity/get-scan-subscription-limits.html
api_method: GET
api_endpoint: "/apicontroller/v1/scan/getScanSubscriptionLimits"
api_url: "https://daas.digicert.com/apicontroller/v1/scan/getScanSubscriptionLimits?&accountId=126993"
---

**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

```bash
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

```json
{
    "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

<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>object</td>
<td>Object container for response.</td>
</tr>
<tr>
<td>.. subscriptionExpiryMessage</td>
<td>string</td>
<td>Message with information about the request.<br><strong>Possible values:</strong> <code>valid</code> or <code>true</code>, if the subscription has not expired; <code>error</code> if the subscription has expired.</td>
</tr>
<tr>
<td>.. subscriptionExpirySeverity</td>
<td>string</td>
<td>Message with information about the request.<br><strong>Possible values:</strong> <code>warning</code> (approaching expiration) or <code>null</code> (account subscription is valid).</td>
</tr>
<tr>
<td>.. subscriptionLimitMessage</td>
<td>string</td>
<td>Message with additional information about the subscription limits on scan.</td>
</tr>
<tr>
<td>.. subscriptionLimitSeverity</td>
<td>string</td>
<td>Message with information about the request.<br><strong>Possible values:</strong> <code>error</code> if the subscription has expired.</td>
</tr>
</tbody>
</table>