Get a list of Risk findings

GET 
/v1/risk-findings

Lists and filters DSPM Risk Findings to analyze and prioritize data security risks in the environment. This API returns a list of Risk Findings with detailed information to help prioritize each security Risk Finding. To retrieve detailed information on each Risk Finding, see the /v1/risk-findings/id/{id}[Get a Risk finding by Id] API.

Request

Query Parameters

ruleName.in string[]
ruleName.equals string
dspmTagKey.in string[]
dspmTagKey.equals string
dspmTagValue.in string[]
dspmTagValue.equals string
projectId.in string[]
projectId.equals string
cloudProvider.in string[]

Possible values: [AWS, AZURE, GCP, SNOWFLAKE, FILE_SHARE, O365]

cloudProvider.equals string

Possible values: [AWS, AZURE, GCP, SNOWFLAKE, FILE_SHARE, O365]

affects.in string[]

Possible values: [SECURITY, COMPLIANCE, GOVERNANCE, SECURITY_AND_COMPLIANCE, SECURITY_AND_GOVERNANCE, COMPLIANCE_AND_GOVERNANCE, SECURITY_AND_COMPLIANCE_AND_GOVERNANCE]

affects.equals string

Possible values: [SECURITY, COMPLIANCE, GOVERNANCE, SECURITY_AND_COMPLIANCE, SECURITY_AND_GOVERNANCE, COMPLIANCE_AND_GOVERNANCE, SECURITY_AND_COMPLIANCE_AND_GOVERNANCE]

status.in string[]

Possible values: [OPEN, CLOSED, UNIMPORTANT, WRONG, HANDLED, INVESTIGATING]

status.equals string

Possible values: [OPEN, CLOSED, UNIMPORTANT, WRONG, HANDLED, INVESTIGATING]

sort string[]
page int32
size integer

Possible values: <= 50

Default value: 20

Header Parameters

dig-api-key stringrequired

Dig token header

Responses

200

Returns a list of risk findings

Response Headers

• X-Total-Count integer

  The total number of items in the page

application/json

Schema

Schema

• Array [
id string
ruleName string
severity string

Possible values: [LOW, MEDIUM, HIGH]

asset object
name string
assetId string
status string

Possible values: [OPEN, CLOSED, UNIMPORTANT, WRONG, HANDLED, INVESTIGATING]

projectId string
cloudProvider string

Possible values: [AWS, AZURE, GCP, SNOWFLAKE, FILE_SHARE, O365]

cloudEnvironment string

Possible values: [UNKNOWN, DEVELOPMENT, STAGING, TESTING, PRODUCTION]

firstDiscovered date-time
complianceStandards object
property name* string[]
Array [
string
]
• ]

Example (from schema)

[
  {
    "id": "string",
    "ruleName": "string",
    "severity": "LOW",
    "asset": {
      "name": "string",
      "assetId": "string"
    },
    "status": "OPEN",
    "projectId": "string",
    "cloudProvider": "AWS",
    "cloudEnvironment": "UNKNOWN",
    "firstDiscovered": "2024-07-29T15:51:28.071Z",
    "complianceStandards": {}
  }
]

Loading...