List Scans
Returns a list of scans where you have at least CAN VIEW [16] scan permissions.
**Note:** Keep in mind potential [rate limits](doc:rate-limiting) when using this endpoint. To check the status of your scans, use the [GET /scans/{scan_id}/latest-status](ref:scans-get-latest-status) endpoint. Tenable recommends the [GET /scans/{scan_id}/latest-status](ref: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](doc: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
{
"value": {
"folders": [
{
"custom": 0,
"default_tag": 0,
"id": 8,
"name": "Trash",
"type": "trash",
"unread_count": 0
},
{
"custom": 0,
"default_tag": 1,
"id": 9,
"name": "My Scans",
"type": "main",
"unread_count": 0
}
],
"scans": [
{
"control": false,
"creation_date": 1430933086,
"enabled": false,
"id": 11,
"last_modification_date": 1430934526,
"legacy": false,
"name": "KitchenSinkScan",
"owner": "user2@example.com",
"permissions": 128,
"read": true,
"schedule_uuid": "b0eeabbe-a612-429a-a60e-0f68eafb8c36f60557ee0e264228",
"shared": false,
"status": "imported",
"user_permissions": 128,
"uuid": "fd7d0d8e-c0e1-4439-97a5-d5c3a5c2d369ab8f7ecb158c480e"
},
{
"control": true,
"creation_date": 0,
"enabled": true,
"id": 26,
"last_modification_date": 0,
"name": "Full Network Scan",
"owner": "user2@example.com",
"permissions": 128,
"read": true,
"schedule_uuid": "template-8b64a4a8-50b4-4077-bcc4-31f451fa3549f4f660ba792e0b0f",
"shared": false,
"status": "empty",
"timezone": "US/Central",
"user_permissions": 128
},
{
"control": true,
"creation_date": 0,
"enabled": false,
"id": 25,
"last_modification_date": 0,
"name": "test-scan-2",
"owner": "user2@example.com",
"permissions": 128,
"read": true,
"schedule_uuid": "template-ecca2c55-a91a-4d3a-b8a9-ca6c7b6ad08a10499ad7667391df",
"shared": false,
"status": "empty",
"user_permissions": 128
},
{
"control": true,
"creation_date": 0,
"enabled": false,
"id": 23,
"last_modification_date": 0,
"name": "test-scan",
"owner": "user2@example.com",
"permissions": 128,
"read": true,
"schedule_uuid": "template-a941666f-1b95-47f2-8a7c-e9895e8444770c27f2a930c2c843",
"shared": false,
"status": "empty",
"user_permissions": 128
},
{
"control": true,
"creation_date": 0,
"enabled": false,
"id": 21,
"last_modification_date": 0,
"name": "basic Scan",
"owner": "user2@example.com",
"permissions": 128,
"read": true,
"schedule_uuid": "template-0a49e290-ae4e-4f95-b49f-15692b74f7b6e1c068e70183409e",
"shared": false,
"status": "empty",
"user_permissions": 128
}
],
"timestamp": 1544146142
}
}
Workflow Library Example
List Scans with Tenable and Send Results Via Email
Preview this Workflow on desktop