Skip to main content
GET
/
v1
/
validations
/
{validation_id}
Retrieve a Transaction Validation
curl --request GET \
  --url https://tracer.lerian.io/v1/validations/{validation_id} \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <x-api-key>'
{
  "validationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "transactionType": "CARD",
  "subType": "<string>",
  "amount": 123,
  "currency": "<string>",
  "transactionTimestamp": "2023-11-07T05:31:56Z",
  "decision": "ALLOW",
  "reason": "<string>",
  "account": {
    "accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "checking",
    "status": "active",
    "metadata": {}
  },
  "segment": {
    "segmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "metadata": {}
  },
  "portfolio": {
    "portfolioId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "metadata": {}
  },
  "merchant": {
    "merchantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "category": "<string>",
    "country": "<string>",
    "metadata": {}
  },
  "metadata": {},
  "matchedRuleIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "evaluatedRuleIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "limitUsageDetails": [
    {
      "limitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "limitAmount": 123,
      "currentUsage": 123,
      "exceeded": true,
      "period": "DAILY",
      "scope": "<string>",
      "attemptedAmount": 123
    }
  ],
  "processingTimeMs": 123,
  "totalRulesLoaded": 123,
  "truncated": true,
  "createdAt": "2023-11-07T05:31:56Z"
}

Headers

​
Content-Type
string
required

The type of media of the resource. Must be application/json.

​
X-API-Key
string
required

The API Key for authentication. This header is required for all endpoints except health checks.

​
X-Request-Id
string<uuid>

A unique identifier used to trace and track each request.

Path Parameters

​
validation_id
string<uuid>
required

The unique identifier of the transaction validation that you want to retrieve.

Response

Indicates that the request was successful and the response contains the expected data.

Full transaction validation record.

​
validationId
string<uuid>

Server-generated unique identifier for this validation record.

​
requestId
string<uuid>

Client-provided request identifier for correlation.

​
transactionType
enum<string>

Type of transaction (payment method).

Available options:
CARD,
WIRE,
PIX,
CRYPTO
​
subType
string

Transaction subtype for additional context.

​
amount
integer

Transaction amount in cents (smallest currency unit).

​
currency
string

ISO 4217 currency code.

​
transactionTimestamp
string<date-time>

When the transaction occurred.

​
decision
enum<string>

Validation decision.

Available options:
ALLOW,
DENY,
REVIEW
​
reason
string

Human-readable reason for the decision.

​
account
object

Account context for validation.

​
segment
object

Segment context (optional). If provided, segmentId is required.

​
portfolio
object

Portfolio context (optional). If provided, portfolioId is required.

​
merchant
object

Merchant context (optional, recommended for card transactions). If provided, merchantId is required.

​
metadata
object

Custom key-value pairs provided in the request.

​
matchedRuleIds
string<uuid>[]

IDs of rules that matched and triggered the decision.

​
evaluatedRuleIds
string<uuid>[]

IDs of all rules that were evaluated.

​
limitUsageDetails
object[]

Details about each limit checked during validation.

​
processingTimeMs
integer

Processing time in milliseconds.

​
totalRulesLoaded
integer

Total number of rules loaded for evaluation.

​
truncated
boolean

Whether the response was truncated due to size limits.

​
createdAt
string<date-time>

When the validation record was created.