List Suspicious Transactions
Retrieve transactions flagged as suspicious by the fraud detection system.
Endpoint
GET /api/v1/transactions/suspicious
Authentication
Bearer token (Compliance or Admin JWT)
Query Parameters
Records per page (max 100)
Start date (YYYY-MM-DD), defaults to 30 days ago
End date (YYYY-MM-DD), defaults to today
Risk level: low, medium, high, critical, or all
Review status: pending, under_review, cleared, confirmed, or all
Filter by subscriber UUID
sort_by
string
default:"created_at"
Sort field: created_at, amount, severity, risk_score
Response
{
"success": true,
"message": "Suspicious transactions retrieved successfully",
"data": {
"transactions": [
{
"id": "sus_abc123",
"transaction_id": "txn_xyz789",
"type": "transfer_p2p",
"amount": 500000,
"risk_score": 85,
"severity": "high",
"review_status": "pending",
"flags": ["unusual_amount", "new_recipient"],
"suspicious_indicators": [
"Amount 10x higher than average",
"First transaction to this recipient"
],
"created_at": "2025-01-15T10:30:00Z"
}
],
"pagination": {
"current_page": 1,
"page_size": 20,
"total_records": 45,
"total_pages": 3,
"has_next": true,
"has_previous": false
},
"summary": {
"total_suspicious": 45,
"pending_review": 20,
"under_review": 10,
"cleared": 12,
"confirmed_fraud": 3
}
}
}
| Code | Description |
|---|
| 400 | Invalid date format |
| 401 | Unauthorized |
| 403 | Insufficient permissions |
| 500 | Internal server error |