Skip to main content
GET
/
api
/
v1
/
transactions
/
suspicious
List Suspicious Transactions
curl --request GET \
  --url https://api.example.com/api/v1/transactions/suspicious \
  --header 'Authorization: <authorization>'

List Suspicious Transactions

Retrieve transactions flagged as suspicious by the fraud detection system.

Endpoint

GET /api/v1/transactions/suspicious

Authentication

Authorization
string
required
Bearer token (Compliance or Admin JWT)

Query Parameters

page
integer
default:"1"
Page number
page_size
integer
default:"20"
Records per page (max 100)
from_date
string
Start date (YYYY-MM-DD), defaults to 30 days ago
to_date
string
End date (YYYY-MM-DD), defaults to today
severity
string
default:"all"
Risk level: low, medium, high, critical, or all
status
string
default:"all"
Review status: pending, under_review, cleared, confirmed, or all
subscriber_id
string
Filter by subscriber UUID
agent_id
string
Filter by agent UUID
transaction_type
string
default:"all"
Transaction type filter
min_amount
number
Minimum amount filter
max_amount
number
Maximum amount filter
sort_by
string
default:"created_at"
Sort field: created_at, amount, severity, risk_score
sort_order
string
default:"desc"
Sort order: asc or desc

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
    }
  }
}

Errors

CodeDescription
400Invalid date format
401Unauthorized
403Insufficient permissions
500Internal server error