Rule Evaluation

Evaluate a transaction against the business's compliance rules.

Evaluate Transaction

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

rule_codesstring[]Required

List of rule codes to evaluate. An empty list evaluates all of the business's active rules. A listed code with no active configuration is reported in data.results with status: "error" rather than omitted.

Responses

200

Evaluation completed. Per-rule verdicts are in data.results, which carries one entry for every rule evaluated and one for every requested rule_codes entry that has no active configuration.

application/json

anyOptional

401

Unauthorized

application/json

404

Not found

422

Unprocessable Entity - Validation Error

application/json

500

Internal Server Error

application/json

post/api/v2/engine/evaluate

POST /api/v2/engine/evaluate HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 459

{
  "transaction": {
    "transaction_id": "txn-2026-08-31-000417",
    "originator_address": "3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy",
    "originator_name": "Ada Tester",
    "originator_account_reference_id": "acct-orig-1042",
    "beneficiary_address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "beneficiary_name": "Grace Receiver",
    "beneficiary_account_reference_id": "acct-benf-2087",
    "amount": 18500,
    "currency": "AED",
    "country_code": "AE",
    "metadata": {
      "channel": "web",
      "product": "spot"
    }
  },
  "rule_codes": []
}

{
  "status": "success",
  "data": {
    "transaction_id": "txn-2026-08-31-000417",
    "evaluated_at": "2026-08-31T09:14:22.418293",
    "results": [
      {
        "rule_code": "TransferThresholdByCountry",
        "status": "pass"
      }
    ]
  }
}