List Scans

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

**Note:** Keep in mind potential rate limits when using this endpoint. To check the status of your scans, use the GET /scans//latest-status endpoint. Tenable recommends the GET /scans//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.

External Documentation

To learn more, visit the Tenable documentation.

​

Parameters

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.

​

Example Output

{
	"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
}