Skip to main content
GET
List Compliance Data with Conditional Findings

Authorizations

X-API-KEY
string
header
required
X-CONNECTION-ID
string
header
required

Query Parameters

updatedSince
string<date-time> | null

Only controls whose updated_at is at or after this time. Leen bumps updated_at whenever any field changes, so this is the incremental-sync filter. Example: 2021-01-01T00:00:00+00:00.

Example:

"2021-01-01T00:00:00+00:00"

cursor
string | null

Opaque position of the next page, taken from the previous response. Ignore its contents; it encodes where the walk had reached.

limit
integer
default:100

How many records to return per page. The walk is the same either way; a larger page means fewer round trips and more memory per response.

Required range: 1 <= x <= 500
includeFindings
boolean
default:false

Include findings data (only for FAIL status compliances)

complianceStatus
string | null

Filter by one or more compliance status. Valid values: PASS, FAIL, NOT_APPLICABLE, DELETED

Example:

"PASS, FAIL"

standard
string | null

Filter by one or more standard (partial match, case insensitive)

Example:

"AWS Best Practices, CIS"

includeRules
boolean
default:false

Include the rules each control cites, with the counts the tool publishes for each, as rules. With includeFindings, each finding also names the rule it failed.

Response

Successful Response

items
CSPMComplianceData · object[]
required

The records on this page.

next_cursor
string | null

Opaque position of the next page. Pass it back as cursor to continue; null when this is the last page.

previous_cursor
string | null

Opaque position of the previous page, for walking backwards. Null on the first page.