GET/v1/customers/{id}/risk-profile

Customer Risk Profile (360)

Consolidated near-real-time view of institutional customer risk. Aggregates identity, open investigation items, velocity behaviors, and heuristic rule matches into a single defensible profile.

Authentication ProtocolBearer <API_KEY>

Path Parameters

idintegerRequired

The platform's internal customer identifier.

Transmission Examples

curl

curl -X GET https://api.topsafe.ai/api/v1/customers/74/risk-profile \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "X-API-Key: YOUR_INSTITUTION_KEY"

Schema Response

json

{
  "generated_at": "2026-04-21T10:42:00.545+00:00",
  "customer": {
    "id": 74,
    "full_name": "Blessing Eze",
    "customer_type": "individual",
    "kyc_level": "tier_1",
    "risk_rating": "low",
    "anonymized_at": null,
    "created_at": "2026-03-17T16:58:43"
  },
  "open_items": {
    "alerts_count": 1,
    "cases_count": 1,
    "alerts": [ /* Alert objects */ ],
    "cases": [ /* Case objects */ ]
  },
  "transactions_30d": {
    "window_start": "2026-03-22T10:42:00+00:00",
    "count": 47,
    "total_amount": "12480000.00",
    "max_amount": "2500000.00",
    "by_channel": { "mobile": 30, "pos": 17 },
    "by_type": { "transfer": 40, "withdrawal": 7 },
    "risk_label_counts": { "low": 42, "medium": 4, "high": 1 }
  },
  "rule_triggers_30d": {
    "RULE001": 3,
    "RULE011": 1
  }
}

Preliminary ResourceGet screening results Successive Directive Data Export (DSAR)