Get suspicious transactions

curl --request GET \
  --url https://olive-gateway-a6ba.onrender.com/api/v1/transactions/suspicious \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://olive-gateway-a6ba.onrender.com/api/v1/transactions/suspicious', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://olive-gateway-a6ba.onrender.com/api/v1/transactions/suspicious"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{}

{}

{}

{}

{}

GET

transactions

suspicious

Get suspicious transactions

curl --request GET \
  --url https://olive-gateway-a6ba.onrender.com/api/v1/transactions/suspicious \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://olive-gateway-a6ba.onrender.com/api/v1/transactions/suspicious', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://olive-gateway-a6ba.onrender.com/api/v1/transactions/suspicious"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{}

{}

{}

{}

{}

List Suspicious Transactions

Retrieve transactions flagged as suspicious by the fraud detection system.

Endpoint

GET /api/v1/transactions/suspicious

Authentication

string

required

Bearer token (Compliance or Admin JWT)

Query Parameters

integer

default:"1"

Page number

integer

default:"20"

Records per page (max 100)

string

Start date (YYYY-MM-DD), defaults to 30 days ago

string

End date (YYYY-MM-DD), defaults to today

string

default:"all"

Risk level: low, medium, high, critical, or all

string

default:"all"

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

string

Filter by subscriber UUID

string

Filter by agent UUID

string

default:"all"

Transaction type filter

number

Minimum amount filter

number

Maximum amount filter

string

default:"created_at"

Sort field: created_at, amount, severity, risk_score

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

Code	Description
400	Invalid date format
401	Unauthorized
403	Insufficient permissions
500	Internal 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.

​List Suspicious Transactions

​Endpoint

​Authentication

​Query Parameters

​Response

​Errors

Authorizations

Query Parameters

Response

List Suspicious Transactions

Endpoint

Authentication

Query Parameters

Response

Errors