Export compliance data

post

https://cloud.tenable.com/compliance/export

Exports compliance data that matches the request criteria. The compliance export API does not return results for individual scans. Instead, the exported data is an aggregation / summary of all compliance scan data. As new compliance scans are run, the summary is updated with the latest audit results.

Note: If you do not submit a request body with the POST request, Tenable Vulnerability Management returns a 415 Unsupported Media Type error. If you do not want to use any body parameters, you must still supply an empty JSON body with the request to avoid this error. For example: {}

Note: There are limits for concurrent export requests. For more information, see Concurrency Limiting and Rate Limiting.

Requires the Basic [16] user role or the VM.VM_EXPLORE.VM_EXPLORE.EXPORT custom role privilege. Additionally, requires the Can View access control permission for the asset objects to be exported. See Roles and Permissions.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

num_findings

int32

50 to 10000

Defaults to 5000

Specifies the number of compliance findings per exported chunk. The valid range is 50-10000. The value defaults to 5000 if this parameter is omitted. If you specify a value outside of the supported range, the value defaults to the upper or lower-bound value.

Note: Some chunks may contain fewer findings than the specified num_findings.

asset

array of strings

A list of asset UUIDs for which you want to return compliance data. The list can contain a maximum of 200 asset UUIDs.

asset

filters

object

A list of filters that Tenable Vulnerability Management applies to exported compliance data. Omit the filters object to return compliance data for all assets.

Note: The first_seen filter cannot be used by itself. You must use last_seen and first_seen together or only last_seen. Additionally, when the ACTIVE is specified for the state filter, both ACTIVE and NEW findings are returned.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Returned if your request specifies invalid input parameters. For example, an invalid filter parameter.

403

Returned if you do not have permission to export compliance data.

200Returned if Tenable Vulnerability Management successfully queues a compliance export request.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting and Concurrency Limiting.