API Reference

Complete API documentation for all 10 Risk Intelligence endpoints with parameters and response examples.

Authentication

All API requests require authentication using your API key in the Authorization header:

curl https://api.brainpredict.ai/v1/risk/assessments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Risk API Endpoints

POST/api/v1/risk/intelligence/assess

Assess overall risk using RiskCore AI (95.2% accuracy - HIGHEST)

POST/api/v1/risk/intelligence/cyber/assess

Assess cybersecurity risk using CyberRiskAnalyzer AI (93.8% accuracy)

POST/api/v1/risk/intelligence/compliance/monitor

Monitor compliance risk using ComplianceRiskMonitor AI (92.5% accuracy)

POST/api/v1/risk/intelligence/third-party/assess

Assess third-party vendor risk using ThirdPartyRiskAssessor AI (91.7% accuracy)

POST/api/v1/risk/intelligence/operational/analyze

Analyze operational risk using OperationalRiskAnalyzer AI (90.8% accuracy)

POST/api/v1/risk/intelligence/financial/predict

Predict financial risk using FinancialRiskPredictor AI (94.2% accuracy)

POST/api/v1/risk/intelligence/predict

Predict emerging risks using EmergingRiskDetector AI (89.3% accuracy)

POST/api/v1/risk/intelligence/score/realtime

Calculate real-time risk score using RealTimeRiskScorer AI (92.0% accuracy)

POST/api/v1/risk/intelligence/realtime/score

Alternative endpoint for real-time risk scoring (backward compatibility)

GET/api/v1/risk/intelligence/models/status

Get status of all 25 Risk AI models

Example: Create Risk Assessment

POST /api/risk/assessments
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "title": "Cybersecurity Risk Assessment - Q4 2025",
  "category": "cybersecurity",
  "asset_id": "SERVER-001",
  "data": {
    "vulnerabilities": ["CVE-2024-1234", "CVE-2024-5678"],
    "patch_status": "outdated",
    "network_exposure": "internet-facing",
    "security_controls": ["firewall", "ids", "waf"]
  }
}

Response (200 OK):
{
  "id": "RISK-2024-001",
  "risk_score": 85,
  "risk_level": "Critical",
  "confidence": 0.95,
  "recommendations": [
    "Immediate patching required for CVE-2024-1234",
    "Isolate server from internet exposure",
    "Enable additional WAF rules"
  ],
  "created_at": "2025-10-21T10:30:00Z"
}

API Reference

Authentication

Risk API Endpoints

Example: Create Risk Assessment

Rate Limits & Support

Rate Limits

Need Help?