Suspicious Transactions Summary
Get aggregated statistics about suspicious transactions for dashboards and reports.
Endpoint
GET /api/v1/transactions/suspicious/summary
Authentication
Bearer token (Compliance or Admin JWT)
Query Parameters
Start date (YYYY-MM-DD), defaults to 30 days ago
End date (YYYY-MM-DD), defaults to today
Response
{
"success": true,
"message": "Summary retrieved successfully",
"data": {
"total_suspicious": 45,
"pending_review": 20,
"under_review": 10,
"cleared": 12,
"confirmed_fraud": 3,
"by_severity": {
"low": 15,
"medium": 18,
"high": 10,
"critical": 2
},
"total_amount_flagged": 15000000,
"avg_risk_score": 65.5,
"date_range": {
"from": "2024-12-15",
"to": "2025-01-15"
}
},
"timestamp": "2025-01-15T10:30:00Z"
}
Severity Levels
| Level | Risk Score | Description |
|---|
| Low | 0-30 | Minor anomalies |
| Medium | 31-60 | Notable patterns |
| High | 61-85 | Significant risk |
| Critical | 86-100 | Immediate attention |
| Code | Description |
|---|
| 400 | Invalid date format |
| 401 | Unauthorized |
| 403 | Insufficient permissions |