Britive platform release 2026.09.02 is now live in production.

Get finding data for a CSPM application

Prev Next
Get
/api/cspm/{app}/findings/{findingType}

Returns a page of enriched finding rows for the specified finding type, scoped to exactly one CSPM integration (an app may have multiple integrations, so integration is required). Each row is cross-referenced against Britive's own applications and profiles -- see WizRoleFinding for the shape returned by the wiz-roles finding type.

Security
HTTP
Type bearer
Path parameters
app
stringRequired

CSPM application name (e.g. wiz) -- case-insensitive

findingType
stringRequired

Finding type identifier returned by List all supported finding types (e.g. wiz-roles)

Query parameters
integration
stringRequired

The CSPM integration to fetch findings for, identified by its unique name or its generated id ("cspm-"). Required because an app may have multiple integrations -- findings are always scoped to exactly one.

page
integer

Parameter to specify the page number of the records to retrieve

Default0
size
integer

Parameter to specify the number of records to retrieve per page

Default20
sort
string

parameter to specify the sort parameter and direction

filter
string

Filter finding rows, as "attribute op value[ and attribute op value]..."; op is one of eq, co (contains), sw (starts with). Attributes are finding-type-specific -- see the finding type's row schema (e.g. WizRoleFinding). Not supported: environment, which is resolved after the underlying query runs and so has no column to filter against.

searchText
string

Free-text search, matched (case-insensitive) against every filterable attribute of the finding rows. Same environment exception as filter.

Responses
200

A page of finding rows

object

A page of finding rows

count
integer (int64)

Total number of rows across all pages

page
integer

Page number returned (0-based)

size
integer

Page size requested

data
Array

Finding rows for this page; shape depends on the finding type

400

Unsupported app or unknown finding type

404

No CSPM integration found with the given name/id for this app