Rule Testing API

The Rule Testing API lets operators evaluate selected inactive rules through the live engine in shadow or evaluation mode. This supports safe validation before a rule is activated.

Run A Rule Test

POST/v1/rule-tests/run

Run selected inactive rules against a manual payload or historical replay request.

A request can include one or more rule IDs, a test mode, and either a manual transaction payload or historical replay parameters.

json

{
  "rule_ids": ["rule_123", "rule_456"],
  "mode": "manual",
  "payload": {
    "transaction_id": "test-001",
    "entity_id": "customer-001",
    "amount": 25000,
    "transaction_type": "TRANSFER"
  }
}

View Test History

GET/v1/rule-tests/history

List previous rule test runs for the current organization.

View A Test Run

GET/v1/rule-tests/{runId}

Fetch one rule test run, including selected rules, request parameters, result summary, and per-rule outcomes.

Operating Guidance

Rule testing should not change live transaction decisions. Use it to compare candidate controls, tune thresholds, inspect false-positive risk, and prepare approval evidence before activation.

See Rules And FLM.