List scan exports

get

https://cloud.tenable.com/scans/exports

Returns a list of scan exports generated within the past 30 days that the user is authorized to view. Use this endpoint to monitor the status of scan export requests, determine when the export is ready for download, or troubleshoot errors that occurred during the generation process.

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

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

sort

string

Defaults to created_at:desc

Specifies the property and direction used to sort the results. The format is <property>:<direction>. If omitted, the system uses the default value of created_at:desc.

Supported properties:

export_id — The unique identifier (UUID) for the export.
created_at — The date and time the export was created.
updated_at — The date and time the export was last updated.
ready_at — The date and time the export became ready for download.

Supported directions:

asc — Ascending order.
desc — Descending order.

offset

integer

≥ 0

Defaults to 0

Specifies the number of records to skip for offset-based pagination. If omitted, the system uses the default value of 0.

limit

integer

1 to 5001

Defaults to 20

Specifies the maximum number of records to return. If omitted, the system uses the default value of 20. The maximum allowed value is 5001.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

403

Returned if you do not have permission to list scan exports. For more information, see Roles and Permissions.

200Returned if the list of scan exports 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.