Skip to main content
GET
/
transactions
/
suspicious
Get suspicious transactions
curl --request GET \
  --url https://olive-gateway-a6ba.onrender.com/api/v1/transactions/suspicious \
  --header 'Authorization: <api-key>'
{}

Documentation Index

Fetch the complete documentation index at: https://docs.vultlocal.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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

Authorizations

​
Authorization
string
header
required

JWT token from admin login for administrative operations. Format: 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

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)

​
to_date
string

End date (YYYY-MM-DD)

​
severity
string
default:"all"

Risk severity: low, medium, high, critical, all

​
status
string
default:"all"

Review status: pending, under_review, cleared, confirmed, all

​
subscriber_id
string

Filter by subscriber ID

​
agent_id
string

Filter by agent ID

​
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, desc

Response

Suspicious transactions retrieved

The response is of type object.