stable

Get Risk Score

Retrieve the current risk score for a specific account or transaction.

Account Risk Score

GET{AML_CORE_URL}/amlcore/api/v1/analytics/risk-score/{accountNumber}

Fetches the SAR-based risk score for a given account number. The risk score is calculated based on the number and severity of SARs filed against the account.

Path Parameters

Field	Type	Required	Description	Example
accountNumber	string	Required	The account number to calculate risk score for	—

Example Request

cURL

curl -X GET AML_CORE/amlcore/api/v1/analytics/risk-score/ACC-001 \
  -H "Authorization: Bearer fl_live_abc123"

Example Response

JSON

{
  "timestamp": "2026-06-01T12:00:00Z",
  "status": 200,
  "message": "Success",
  "correlationId": "fl-abc123",
  "data": {
    "accountNumber": "ACC-001",
    "score": 68,
    "riskLevel": "HIGH",
    "totalSars": 3,
    "recentSars": 1,
    "calculatedAt": "2026-06-01T12:00:00Z"
  }
}

Response Fields

Field	Type	Required	Description	Example
accountNumber	string	Optional	The account number	—
score	integer	Optional	Overall risk score (0-100)	—
riskLevel	string	Optional	Accepted: LOW, MEDIUM, HIGH, CRITICAL	—
totalSars	integer	Optional	Total number of SARs filed against this account	—
recentSars	integer	Optional	Number of SARs filed in the recent period	—
calculatedAt	string	Optional	When the score was calculated	—

Transaction Risk Assessment

GET{AML_CORE_URL}/amlcore/api/v1/transactions/{transactionUuid}/risk-assessment

Returns the full risk assessment with explainability trail for a transaction. See the Transactions API for details.

See Transactions API

The full risk assessment response fields are documented in the Transactions API reference.

Error Codes

Code	Message
404	Account or transaction not found.