DocumentationAPI ExplorerRecipesConnectChangelogRSSSubscribe
API Explorer

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 /scans/{scan_id}/latest-status endpoint. Tenable recommends the GET /scans/{scan_id}/latest-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.

integer

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.

integer

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

integer

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 1 month ago

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 1 month ago