Get risk management insights

Get risk management insights

🔒 Requires Risk Management: List Insights permission.

💎 Requires your account have the Risk Management Pro feature. Contact your CSM for help upgrading.

Securitybearer
Request
query Parameters
categoriesIds
Array of numbers

List of categories ids to find risks by

Example: categoriesIds=1&categoriesIds=2&categoriesIds=3
ownersIds
Array of numbers

List of owners ids to find risks by

Example: ownersIds=1&ownersIds=2&ownersIds=3
riskFilter
string

Filter risks with a specific condition

Enum: "NEEDS_ATTENTION" "CUSTOM_ONLY" "INTERNAL_ONLY" "EXTERNAL_ONLY"
Example: riskFilter=INTERNAL_ONLY
status
Array of strings

Type for risk status

Items Enum: "ACTIVE" "ARCHIVED" "CLOSED"
Example: status=ACTIVE
Responses
200

Successful

400

Malformed data and/or validation errors

401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

get/risk-management-insights
Request samples 
Response samples 
application/json
{
  • "riskPosture": {
    • "LOW": 23,
    • "CRITICAL": 13
    },
  • "treatmentOverview": {
    • "ACCEPT": 23,
    • "TRANSFER": 13
    },
  • "riskHeatmap": [
    • {
      • "total": 11,
      • "impact": 2,
      • "likelihood": 2
      }
    ],
  • "categoryBreakdown": [
    • {
      • "severity": {
        • "MEDIUM": 1,
        • "CRITICAL": 2
        },
      • "category": {
        • "id": 2,
        • "name": "Access Control"
        }
      }
    ],
  • "scored": 63,
  • "remaining": 8
}