---
title: "List scheduled jobs"
source_url: https://dev.digicert.com/certcentral-apis/discovery-api/scan-activity/list-scheduled-jobs.html
api_method: POST
api_endpoint: "/apicontroller/v1/scan/futureScanJobs"
api_url: "https://daas.digicert.com/apicontroller/v1/scan/futureScanJobs"
---

**POST** `https://daas.digicert.com/apicontroller/v1/scan/futureScanJobs`

Use this endpoint to get a list of information about all scheduled jobs for a scan.

## Example requests and responses

## cURL

```bash
curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/scan/futureScanJobs' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{"accountId":"5153184","divisionId":677793,"surveyDefId":293514,"startIndex":1,"pageSize":10}'
```

## 200 OK

```json
{
    "error": null,
    "data": {
        "scanJobDTOList": [
            {
                "jobId": "1591099200000",
                "startTime": 1591099200000,
                "state": 11
            },
            {
                "jobId": "1594123200000",
                "startTime": 1594123200000,
                "state": 11
            },
            {
                "jobId": "1596542400000",
                "startTime": 1596542400000,
                "state": 11
            },
            {
                "jobId": "1598961600000",
                "startTime": 1598961600000,
                "state": 11
            },
            {
                "jobId": "1601985600000",
                "startTime": 1601985600000,
                "state": 11
            },
            {
                "jobId": "1604404800000",
                "startTime": 1604404800000,
                "state": 11
            },
            {
                "jobId": "1606824000000",
                "startTime": 1606824000000,
                "state": 11
            },
            {
                "jobId": "1609848000000",
                "startTime": 1609848000000,
                "state": 11
            },
            {
                "jobId": "1612267200000",
                "startTime": 1612267200000,
                "state": 11
            },
            {
                "jobId": "1614686400000",
                "startTime": 1614686400000,
                "state": 11
            }
        ],
        "totalCount": 2147483647,
        "currentCount": 10
    }
}
```

## Request 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>surveyDefId</td>
<td>required</td>
<td>integer</td>
<td>Survey definition ID of the scan. To get a list of <code>surveyDefId</code> values for your scans, use the <a href="https://dev.digicert.com/md/certcentral-apis/discovery-api/list-and-filter/scan-list.md">scan list</a> endpoint.</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>
</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>.. scanJobDTOList</td>
<td>array</td>
<td>Array of objects with details about scheduled jobs for the scan.</td>
</tr>
<tr>
<td>.. .. jobId</td>
<td>string</td>
<td>Scan job ID.</td>
</tr>
<tr>
<td>.. .. startTime</td>
<td>string</td>
<td>Start time for the scheduled scan.<br><strong>Example: <code>1596781119</code></strong><br><strong>Note:</strong> <code>startTime</code> value should be <code>0</code> when the <code>frequencytype</code> is <code>onetime</code></td>
</tr>
<tr>
<td>.. .. state</td>
<td>integer</td>
<td>State of the scan. For definitions, see the <a href="#filter-options-for-searchcriterialist">Scan states</a> table below.</td>
</tr>
<tr>
<td>totalCount</td>
<td>integer</td>
<td>Total number of scans in account.</td>
</tr>
<tr>
<td>currentCount</td>
<td>integer</td>
<td>Number of scans currently visible.</td>
</tr>
</tbody>
</table>

## Scan states

<table>
<thead>
<tr>
<th>State</th>
<th>Value</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>10</code></td>
<td><code>IN_PROGRESS</code></td>
</tr>
<tr>
<td><code>11</code></td>
<td><code>COMPLETED</code></td>
</tr>
<tr>
<td><code>12</code></td>
<td><code>FAILED</code></td>
</tr>
<tr>
<td><code>13</code></td>
<td><code>PARTIAL</code></td>
</tr>
<tr>
<td><code>15</code></td>
<td><code>IDLE</code></td>
</tr>
<tr>
<td><code>16</code></td>
<td><code>SKIPPED</code></td>
</tr>
<tr>
<td><code>19</code></td>
<td><code>CANCELLED</code></td>
</tr>
</tbody>
</table>