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

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

Use this endpoint to get a list of information about past scan jobs, including the start and end time.

## Example requests and responses

## cURL

```bash
curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/scan/pastScanJobs' \
--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": "294443",
                "percentageCompleted": 20.0,
                "state": 11,
                "duration": 108,
                "startTime": 1588848332168,
                "endTime": 1588848440203,
                "vulStartTime": null,
                "vulEndTime": null,
                "vulState": null,
                "vulEnabled": true,
                "emulationScans": false,
                "vulPercentageCompleted": 0.0,
                "vulDuration": null,
                "hasResults": false
            }
        ],
        "totalCount": 1,
        "currentCount": 1
    }
}
```

## 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>.. .. percentageCompleted</td>
<td>float</td>
<td>Scan percentage completed.</td>
</tr>
<tr>
<td>.. .. state</td>
<td>integer</td>
<td>State of the scan. For definitions, see the Scan states table below.</td>
</tr>
<tr>
<td>.. .. duration</td>
<td>integer</td>
<td>Duration used for the scan.</td>
</tr>
<tr>
<td>.. .. startTime</td>
<td>integer</td>
<td>Start time of the scan.</td>
</tr>
<tr>
<td>.. .. endTime</td>
<td>integer</td>
<td>End time of the scan.</td>
</tr>
<tr>
<td>.. .. vulStartTime</td>
<td>integer</td>
<td>Vulnerability discovery start time.</td>
</tr>
<tr>
<td>.. .. vulEndTime</td>
<td>integer</td>
<td>Vulnerability discovery end time.</td>
</tr>
<tr>
<td>.. .. vulState</td>
<td>integer</td>
<td>Status of the vulnerability.</td>
</tr>
<tr>
<td>.. .. vulEnabled</td>
<td>integer</td>
<td>Whether vulnerability is enabled.</td>
</tr>
<tr>
<td>.. .. emulationScans</td>
<td>integer</td>
<td>If <code>true</code>, it will exclude <code>Heartbleed</code> and <code>POODLE (TLS)</code> from vulnerability discovery.</td>
</tr>
<tr>
<td>.. .. vulPercentageCompleted</td>
<td>float</td>
<td>Vulnerability scan percentage completed.</td>
</tr>
<tr>
<td>.. .. vulDuration</td>
<td>integer</td>
<td>Vulnerability scan duration in milliseconds.</td>
</tr>
<tr>
<td>.. .. hasResults</td>
<td>boolean</td>
<td>If <code>true</code>, scan results discovered certificates.</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>