Simulate a match rule against a context (read-only dry run)
Previews how a single rule — an existing configured rule (ruleId) OR an inline candidate rule (rule) — would match a context’s unmatched transactions, WITHOUT committing anything. Returns the number of 1:1 groups the rule would form, a bounded sample of would-match pairs (each with a confidence score, a per-component rationale (the “why”), and matched composite keys), and the per-side unmatched counts. Powers the rule-authoring “will this rule actually match?” preview. Scope: scored by the deterministic rule engine over raw transaction amounts; it does NOT apply run-time fee normalization or the FX-variance band, and previews only 1:1 pairwise grouping (no 1:N/N:M allocation). Nothing is persisted; the tenant is taken from the JWT, never the body.
Authorizations
Bearer token authentication (format: "Bearer {token}")
Body
Context ID whose transactions the rule is simulated against
Inline candidate rule to preview. Provide this OR ruleId, not both.
Identifier of an existing configured rule to preview. Provide this OR rule, not both.
Maximum number of would-match pairs to return in the sample
1 <= x <= 200Response
OK
Number of 1:1 groups the rule would form across the context
x >= 012
Strategy of the previewed rule
"EXACT"
Bounded sample of would-match pairs (highest score first)
200Whether matchedGroups exceeds the returned sample length
false
Left-side transactions that would remain unmatched
x >= 03
Right-side transactions that would remain unmatched
x >= 05
Identifier of the previewed rule. Empty for an inline candidate rule (not persisted).
"550e8400-e29b-41d4-a716-446655440000"

