DocumentationAPI ExplorerRecipesConnectChangelogRSSSubscribe
API Explorer
  1. Vulnerability Management
  2. Scans

List scans

get
https://cloud.tenable.com/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 latest scan status endpoint. Tenable recommends the Get latest scan status endpoint especially if you are programmatically checking the status of large numbers of scans.

Requires the Basic [16] user role and the Can View [16] scan permission. Alternatively, requires the VM.VM_SCAN.VM_SCAN.READ custom role privilege . See Roles and Permissions.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer

The unique identifier of the folder to filter by. When provided, only scans within this folder are returned.

int64

Filters results to scans that are either currently active or were executed on or after the specified Unix timestamp (in seconds).

Note: Despite the parameter name, this refers to the scan execution time, not the date the scan configuration was last modified.

int64

Filters results to scans started on or after the specified Unix timestamp (in seconds).

int64

Filters results to scans started on or before the specified Unix timestamp (in seconds).

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 2 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html

Updated about 2 months ago

Did this page help you?