Validate a transaction

Use this endpoint to validate a transaction against configured rules and limits in real-time. Returns a decision (ALLOW, DENY, or REVIEW) along with details about which rules matched and limit usage.

POST /v1/validations

Validate a transaction

cURL

curl --request POST \
  --url https://tracer.sandbox.lerian.net/v1/validations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '"<string>"'

200

{
  "decision": "ALLOW",
  "evaluatedAt": "2021-01-01T00:00:00Z",
  "evaluatedRuleIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "limitUsageDetails": [
    {
      "attemptedAmount": "100.00",
      "currentUsage": "500.00",
      "exceeded": true,
      "limitAmount": "1000.00",
      "limitId": "00000000-0000-0000-0000-000000000000",
      "period": "DAILY",
      "scope": "account:00000000-0000-0000-0000-000000000000",
      "skipReason": "outside_time_window",
      "skipped": true
    }
  ],
  "matchedRuleIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "processingTimeMs": 12.5,
  "reason": "Transaction denied by rule 'Block high-value checking transactions'",
  "requestId": "00000000-0000-0000-0000-000000000000",
  "totalRulesLoaded": 42,
  "truncated": false,
  "validationId": "00000000-0000-0000-0000-000000000000"
}

Authorizations

BearerAuthApiKeyAuth

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Body

application/json

The body is of type file.

Response

200

application/json

OK

decision · string · required

Example:

"ALLOW"

evaluatedAt · string<date-time> · required

Example:

"2021-01-01T00:00:00Z"

evaluatedRuleIds · string<uuid>[] | null · required

limitUsageDetails · object[] | null · required

Show child attributes

matchedRuleIds · string<uuid>[] | null · required

processingTimeMs · number<double> · required

Example:

12.5

reason · string · required

Example:

"Transaction denied by rule 'Block high-value checking transactions'"

requestId · string<uuid> · required

Example:

"00000000-0000-0000-0000-000000000000"

totalRulesLoaded · integer<int64> · required

Example:

42

truncated · boolean · required

Example:

false

validationId · string<uuid> · required

Example:

"00000000-0000-0000-0000-000000000000"