Export scan

Exports the a scan in the specified format. Use the Check scan export status endpoint to see the status of the requested export. On receiving a ready status, download the export file using the Download scan export endpoint.

If you request a scan export in the nessus file format, but do not specify filters for the export, Tenable Vulnerability Management truncates the plugins output data in the export file at 5 MB or 5,000,000 characters, and appends TRUNCATED (bracketed by three asterisks) at the end of the output in the export file. You can obtain the full plugins output by exporting a scan in any file format other than nessus or db.

Additionally, scan exports in the db format do not contain the full scan data set, and they are sourced from the scan task prior to the scan being indexed/processed. Scan db exports only contain the data for the hosts specified in the export request with the asset_id body parameter. Agent scan db exports contain only one host (the agent), and you can't export triggered agent scans.

Note: Vulnerability findings with a first_observed date within the last 14 days are marked in the exported results as being in the New state. Vulnerability findings with a first_observed date older than 14 days are marked in the exported results as being in the Active state.

Requires the Scan Operator [24] user role and the Can View [16] scan permission. Alternatively, requires the VM.VM_SCAN.VM_SCAN.EXPORT custom role privilege. See Roles and Permissions.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
Loading…
Responses

400

Returned under the following conditions:

  • Your request message is missing a required parameter.
  • The format parameter in your request specified an unsupported export format for scan results that are older than 60 days. Only nessus and csv formats are supported for scan results that are older than 60 days.
  • Your request included filter query parameters for scan results that are older than 60 days.

403

Returned if you do not have permission to export scans. For more information, see Roles and Permissions.

404

Returned if the specified scan was not be found.

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