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

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
}