Export findings

post

https://cloud.tenable.com/pci-asv/finding/export

Creates an export of your PCI ASV findings and returns the identifier you use to track it. Tenable prepares the export asynchronously: poll the Get findings export status endpoint until the status is COMPLETED, then download each chunk with the Download findings export chunk endpoint.

Note: You can create a maximum of three exports every 60 seconds.

Note: You need to request access to this endpoint through Tenable support even if you have a valid PCI ASV license.

Requires the Administrator [64] user role or the PCI.PCI_REMEDIATION.WRITE custom role privilege. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

chunk_size

integer

required

50 to 2000

Specifies the number of findings to include in each chunk of the export. Valid values range from 50 to 2000.

attestations

array of strings

Returns findings associated with the specified attestations. Use the List attestations endpoint to determine an attestation UUID. If your request omits this parameter, the export includes findings from all attestations.

attestations

assets

array of strings

Returns findings for the specified assets. Use the List attestation assets endpoint to determine an asset UUID. If your request omits this parameter, the export includes findings for all assets.

assets

severity

array of strings

Returns findings at the specified severity levels. If your request omits this parameter, the export includes findings at all severity levels.

Note: This parameter uses the severity level names, while the severity property of an exported finding is a numeric level.

severity

Allowed:

Responses

200Returned if the export was created successfully.

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.

403Returned if you do not have permission to export findings.

429Returned if you attempt to send too many requests in a specific period of time or if you attempt to create more than three exports within 60 seconds. For more information, see Rate Limiting.

500Returned if an internal error occurred.