---
title: "Get cloud scan activity"
source_url: https://dev.digicert.com/certcentral-apis/discovery-api/cloud-scan/get-cloud-scan-activity.html
api_method: GET
api_endpoint: "/apicontroller/v1/scan/getCloudScanActivity"
api_url: "https://daas.digicert.com/apicontroller/v1/scan/getCloudScanActivity"
---

**GET** `https://daas.digicert.com/apicontroller/v1/scan/getCloudScanActivity`

Use this endpoint to get information about the activities enabled for an existing cloud scan template.

## Example requests and responses

## cURL

```bash
curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/scan/getCloudScanActivity' \
--header 'X-DC-DEVKEY: {{api_key}} ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accountId": 126993,
    "searchCriteriaList": [],
    "startIndex": 1,
    "pageSize": 50,
    "sortedColumn": "domain",
    "sortOrder": "ASC"
}'
```

## 200 OK

```json
{
    "error": null,
    "data": {
        "percentage": 0,
        "status": "in_progress",
        "totalCount": 3,
        "cloudscanActivity": [
            {
                "id": 14809443,
                "type": "Included",
                "domain": "amazon.com",
                "status": "in_progress",
                "updatedDate": 1588786078633,
                "lastCompletedDate": 1588786078633
            },
            {
                "id": 14809442,
                "type": "Included",
                "domain": "digicert.com",
                "status": "in_progress",
                "updatedDate": 1588786076973,
                "lastCompletedDate": 1588786076973
            }
        ]
    }
}
```

## URL query 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>divisionId</td>
<td>required</td>
<td>integer</td>
<td>Division ID.</td>
</tr>
<tr>
<td>searchCriteriaList</td>
<td>optional</td>
<td>array</td>
<td>Filter results by specified values. The array includes key, operation, and value.<br><strong>Example:</strong><br><code>searchCriteriaList:[
  {
    &quot;key&quot;:&quot;domain&quot;,
    &quot;operation&quot;:&quot;EQUALS&quot;,
    &quot;value&quot;:[&quot;digicert.com&quot;]
  }
]</code></td>
</tr>
<tr>
<td>startIndex</td>
<td>optional</td>
<td>integer</td>
<td>Start at the specified index.<br><strong>Default:</strong><code>1</code></td>
</tr>
<tr>
<td>pageSize</td>
<td>optional</td>
<td>integer</td>
<td>Number of records per page.<br><strong>Allowed values</strong>: <code>0</code> to <code>512</code></td>
</tr>
<tr>
<td>sortedColumn</td>
<td>optional</td>
<td>string</td>
<td>Sort results by specified parameter.</td>
</tr>
<tr>
<td>sortOrder</td>
<td>optional</td>
<td>string</td>
<td>Sort direction.<br><strong>Allowed values:</strong> <code>DESC</code> (descending: 9-0, Z-A), <code>ASC</code> (ascending: 0-9, A-Z)<br><strong>Default:</strong><code>DESC</code></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>object</td>
<td>Object container for response.</td>
</tr>
<tr>
<td>.. percentage</td>
<td>integer</td>
<td>Completion percentage of the cloud scan.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Status of the cloud scan.<br><strong>Possible values:</strong> <code>Completed</code>, <code>failed</code>, <code>partial</code>, <code>in_progress</code></td>
</tr>
<tr>
<td>.. totalCount</td>
<td>integer</td>
<td>Total number of domains present in the cloud scan.</td>
</tr>
<tr>
<td>.. cloudscanActivity</td>
<td>array</td>
<td>List of objects with details about the activities found for the cloud scan template.</td>
</tr>
<tr>
<td>.. .. id</td>
<td>integer</td>
<td>Domain ID.</td>
</tr>
<tr>
<td>.. .. type</td>
<td>string</td>
<td>IP/Domains to be included or excluded.<br><strong>Possible values:</strong> <code>Included</code>, <code>Excluded</code></td>
</tr>
<tr>
<td>.. .. domain</td>
<td>string</td>
<td>Scanned domain.</td>
</tr>
<tr>
<td>.. .. status</td>
<td>string</td>
<td>Status of scanned domain.<br><strong>Possible values:</strong> <code>Completed</code>, <code>failed</code>, <code>added</code>, <code>in_progress</code></td>
</tr>
<tr>
<td>.. .. updatedDate</td>
<td>integer</td>
<td>Date when the domain was last updated (epoch in milliseconds).</td>
</tr>
<tr>
<td>.. .. lastCompletedDate</td>
<td>integer</td>
<td>Date when the domain was last scanned via cloud scanner (epoch in milliseconds).</td>
</tr>
</tbody>
</table>