Get a transaction validation record by ID

Use this endpoint to retrieve a transaction validation record by its unique identifier. Useful for auditing and debugging validation decisions.

GET /v1/validations/{id}

Get a transaction validation record by ID

cURL

curl --request GET \
  --url https://tracer.sandbox.lerian.net/v1/validations/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "account": {
    "accountId": "00000000-0000-0000-0000-000000000000",
    "status": "active",
    "type": "checking",
    "metadata": {}
  },
  "amount": "100.00",
  "asset": "USD",
  "createdAt": "2021-01-01T00:00:00Z",
  "decision": "ALLOW",
  "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,
  "transactionTimestamp": "2021-01-01T00:00:00Z",
  "transactionType": "CARD",
  "truncated": false,
  "validationId": "00000000-0000-0000-0000-000000000000",
  "merchant": {
    "category": "5411",
    "country": "US",
    "merchantId": "00000000-0000-0000-0000-000000000000",
    "name": "Acme Store",
    "metadata": {}
  },
  "metadata": {},
  "portfolio": {
    "portfolioId": "00000000-0000-0000-0000-000000000000",
    "metadata": {},
    "name": "growth"
  },
  "segment": {
    "segmentId": "00000000-0000-0000-0000-000000000000",
    "metadata": {},
    "name": "retail"
  },
  "subType": "purchase"
}

Authorizations

BearerAuthApiKeyAuth

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Path Parameters

id · string · required

Transaction Validation ID (UUID)

Response

200

application/json

OK

account · object · required

Show child attributes

amount · string · required

Example:

"100.00"

asset · string · required

Example:

"USD"

createdAt · string<date-time> · required

Example:

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

decision · string · required

Example:

"ALLOW"

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

transactionTimestamp · string<date-time> · required

Example:

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

transactionType · string · required

Example:

"CARD"

truncated · boolean · required

Example:

false

validationId · string<uuid> · required

Example:

"00000000-0000-0000-0000-000000000000"

merchant · object

Show child attributes

metadata · object

Show child attributes

portfolio · object

Show child attributes

segment · object

Show child attributes

subType · string

Maximum string length: 50

Example:

"purchase"