Get risk management insights

Get risk management insights

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

Good to go!

400

Malformed data and/or validation errors

401

Invalid Authorization

403

You are not allowed to perform this action

500

Internal server error

default

Response Code: 412

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

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
}