> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Scans

Returns a list of scans where you have at least CAN VIEW \[16] scan permissions.

\*\*Note:\*\* Keep in mind potential [rate limits](https://developer.tenable.com/docs/rate-limiting) when using this endpoint. To check the status of your scans, use the [GET /scans/{scan_id}/latest-status](https://developer.tenable.com/reference/scans-get-latest-status) endpoint. Tenable recommends the [GET /scans/{scan_id}/latest-status](https://developer.tenable.com/reference/scans-get-latest-status) endpoint especially if you are programmatically checking the status of large numbers of scans.

Requires BASIC \[16] user permissions and CAN VIEW \[16] scan permissions. See [Permissions](https://developer.tenable.com/docs/permissions).

<Note>
  External Documentation

  To learn more, visit the [Tenable documentation](https://developer.tenable.com/reference/scans-list).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter              | Description                                                                                                                                                                                         |
  | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Folder ID              | The ID of the folder where the scans you want to list are stored.                                                                                                                                   |
  | Last Modification Date | Limit the results to those scans that have run since the specified time. This parameter does not represent the date on which the scan configuration was last modified. Must be in Unix time format. |
</div>

## Example Output

```json theme={"dark"}
{
	"scans": [
		{
			"control": true,
			"creation_date": 575668283,
			"enabled": false,
			"id": 61,
			"last_modification_date": 1924401184,
			"legacy": false,
			"name": "<string>",
			"owner": "<string>",
			"policy_id": 110,
			"read": true,
			"rrules": "<string>",
			"schedule_uuid": "<string>",
			"shared": false,
			"starttime": "20240722T200000",
			"status": "<string>",
			"template_uuid": "<string>",
			"timezone": "<string>",
			"has_triggers": false,
			"type": "<string>",
			"permissions": 202,
			"user_permissions": 163,
			"uuid": "<string>",
			"wizard_uuid": "<string>",
			"progress": 133,
			"total_targets": 365,
			"status_times": {
				"initializing": 298,
				"pending": 88887,
				"processing": 479,
				"publishing": 92050,
				"running": 3815957
			}
		},
		{
			"control": true,
			"creation_date": 1024163111,
			"enabled": true,
			"id": 26,
			"last_modification_date": 3477511010,
			"legacy": false,
			"name": "<string>",
			"owner": "<string>",
			"policy_id": 93,
			"read": false,
			"rrules": "<string>",
			"schedule_uuid": "<string>",
			"shared": false,
			"starttime": "20240722T200000",
			"status": "<string>",
			"template_uuid": "<string>",
			"timezone": "<string>",
			"has_triggers": false,
			"type": "<string>",
			"permissions": 84,
			"user_permissions": 197,
			"uuid": "<string>",
			"wizard_uuid": "<string>",
			"progress": 61,
			"total_targets": 8,
			"status_times": {
				"initializing": 644,
				"pending": 70080,
				"processing": 120,
				"publishing": 59778,
				"running": 1094193
			}
		}
	],
	"folders": [
		{
			"id": 8,
			"name": "<string>",
			"type": "<string>",
			"custom": 2,
			"unread_count": 0,
			"default_tag": 1
		},
		{
			"id": 8,
			"name": "<string>",
			"type": "<string>",
			"custom": 2,
			"unread_count": 2,
			"default_tag": 0
		}
	],
	"timestamp": 1632811002
}
```

## Workflow Library Example

[List Scans with Tenable and Send Results Via Email](https://library.blinkops.com/workflows/list-scans-with-tenable-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-scans-with-tenable-and-send-results-via-email/canvas" />
</div>