Get scan details

Returns scan results for a specific scan. If you submit a request without query parameters, Tenable Vulnerability Management returns results from the latest run of the specified scan. If you submit a request using the query parameters to specify a historical run of the scan, Tenable Vulnerability Management returns the scan results for the specified run.

Note: Keep in mind potential rate limits and concurrency limits when using this endpoint. To check the status of a scan, 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.

Note: This endpoint returns limited data if scan results are older than 35 days. Scans that are older than 35 days are effectively "archived". The info.is_archived attribute in the response message for this endpoint serves as the indication of archival status. For complete data from archived scan results, use the POST /scans/{scan_id}/export endpoint instead.

Requires the Scan Operator [24] 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…
Path Params
required

The unique identifier for the scan. You can use either the schedule_uuid (string) or the id (integer) retrieved from the List Scans endpoint.

Note: Tenable recommends using the schedule_uuid for consistency across scan instances.

Query Params
integer

The unique identifier of the specific scan historical instance you want to retrieve. This value enables you to access data from a previous execution of the scan and corresponds to the id attribute from the Get scan history endpoint.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

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