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

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

folder_id

integer

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

last_modification_date

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.

started_from

int64

Filters results to scans whose most recent run started on or after the specified Unix timestamp (in seconds). The response returns this start time in the creation_date property. Scans that have never run are excluded.

If you also specify started_to, this value must be less than or equal to started_to. Otherwise, the request returns a 400 response.

started_to

int64

Filters results to scans whose most recent run started before the specified Unix timestamp (in seconds). Scans whose most recent run started at exactly the specified time are excluded, so to include an entire day, specify the first second of the following day. The response returns this start time in the creation_date property. Scans that have never run are excluded.

Note: This filter applies only to the most recent run of each scan. A scan that ran during the specified period is excluded if it has run again since.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

200Returned if the list of scans was retrieved successfully.

401Returned if the API keys specified in your request are invalid.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if an internal error occurred.