POST/v4/fraud-assessments/create

Create assessment

Fraud Assessments evaluate arbitrary activity (like logins, purchases, or wire transfers) using your custom Rule Engine and our proprietary Machine Learning models. Integrate this institutional endpoint to sync operational telemetry.

Authentication ProtocolBearer <API_KEY>

Path Parameters

event_typestringRequired

e.g., `transaction`, `login`.

metadataobject

Device, IP, and transaction specifics.

Transmission Examples

curl

curl https://api.topsafe.ai/v4/fraud-assessments/create \
  -H "Authorization: Bearer YOUR_API_KEY"

Schema Response

json

{
  "success": true,
  "data": {
    "id": "fa_77zqq",
    "risk_level": "high",
    "signals": ["ip_distance_suspicious", "velocity_spike"],
    "recommended_action": "block"
  }
}

Successive Directive API Overview