Skip to main content

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​

ParameterDescription
Folder IDThe ID of the folder where the scans you want to list are stored.
Last Modification DateLimit 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

Workflow LibraryPreview this Workflow on desktop