Export findings

post

https://cloud.tenable.com/api/v1/t1/inventory/export/findings

Exports findings in your organization that match the specified search criteria.

Caution: This endpoint is available for use but is currently in beta. The response structure is subject to change as we continue to enhance the data model.

Requires the Basic [16] user role or the ASSET_INVENTORY.CYBER_ASSET_MANAGEMENT.READ and AD.TOGGLE_AD.USE custom role privileges. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

properties

string

Specifies which findings properties to include in the export. Provide multiple properties as a comma-separated list.

By default, if no properties are provided, the export includes the following properties: asset_id, finding_id, finding_name, severity, and state

Use the List findings properties endpoint to retrieve a list of valid properties for this parameter. For example, you might include asset_name, solution, and vpr_score as properties.

use_readable_name

boolean

Defaults to true

When set to true, returns the human-readable names of properties instead of internal key names.

max_chunk_file_size

integer

5242880 to 104857600

Defaults to 20971520

Maximum size, in bytes, for each export chunk when exporting large datasets.

If omitted, the default is 20971520 bytes (20 MB). The maximum value is 104857600 (100 MB) and the minimum value is 5242880 (5 MB).

sort

string

Defaults to application:asc

The property and direction to sort the results by, in the format property:direction. For example: finding_name:asc or severity:desc

file_format

string

enum

Defaults to JSON

Specifies the file format for the export.

Defaults to JSON if not provided. Valid values are CSV and JSON.

Allowed:

compress

boolean

Defaults to false

When set to true, the exported file is compressed using GZIP.

The compressed file retains its original format (CSV or JSON) but is smaller in size, which helps reduce download time and storage requirements. You must decompress the file with a standard GZIP tool before processing. This option is particularly useful for large exports or limited-bandwidth environments.

Body Params

filters

array of objects | null

A set of asset properties used to filter the export results.

Use the List finding properties endpoint to view available finding properties that can be used as filters.

filters

query

object

Filter the export results by query. A query consists of the search mode and query text.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

403

Returned if you do not have permission to export findings.

200Returned if the findings export request was successfully queued.

400Returned if your request specified invalid parameters or if your request was improperly formatted.

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.