List Transaction Validations

Use this endpoint to list transaction validation records with cursor-based pagination and filters. Useful for compliance reporting and trend analysis.

GET /v1/validations

List Transaction Validations

cURL

curl --request GET \
  --url https://tracer.lerian.io/v1/validations \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <api-key>'

200

Example

{
  "transactionValidations": [
    {
      "validationId": "019c96a0-10d2-7193-8841-0d7347efd09a",
      "accountId": "019c96a0-0c0c-7221-8cf3-13313fb60081",
      "segmentId": "019c96a0-0b4e-7079-8be0-ab6bdccf975f",
      "transactionType": "CARD",
      "amount": "1500.00",
      "currency": "BRL",
      "decision": "ALLOW",
      "reason": "Transaction approved",
      "matchedRuleIds": [],
      "exceededLimitIds": [],
      "processingTimeMs": 23,
      "createdAt": "2026-01-30T10:30:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "eyJpZCI6IjEyMzQifQ=="
}

Authorizations

ApiKeyAuthBearerAuth

X-API-Key · string · header · required

API Key authentication. Used by single-tenant deployments (MULTI_TENANT_ENABLED=false). Sent on every /v1/* request.

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.

Query Parameters

limit · integer · default: 100

The maximum number of items to include in the response. Default: 100, Max: 1000

Required range: 1 <= x <= 1000

cursor · string

Pagination cursor from previous response. When using cursor, sortBy and sortOrder cannot be changed.

sort_by · enum<string> · default: created_at

The field used to sort the results.

Available options: created_at, processing_time_ms

sort_order · enum<string> · default: DESC

The order used to sort the results.

Available options: ASC, DESC

start_date · string<date-time>

Filter from this date (inclusive). Must be RFC3339 format with timezone. Defaults to 90 days before current time.

end_date · string<date-time>

Filter to this date (exclusive). Must be RFC3339 format with timezone. Defaults to current time.

decision · enum<string>

Filter by decision (ALLOW, DENY, REVIEW).

Available options: ALLOW, DENY, REVIEW

account_id · string<uuid>

Filter by account ID (UUID).

matched_rule_id · string<uuid>

Filter by matched rule ID (UUID).

exceeded_limit_id · string<uuid>

Filter by exceeded limit ID (UUID).

segment_id · string<uuid>

Filter by segment ID (UUID).

portfolio_id · string<uuid>

Filter by portfolio ID (UUID).

transaction_type · enum<string>

Filter by transaction type.

Available options: CARD, WIRE, PIX, CRYPTO

Response

200

application/json

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

Paginated list of transaction validations (returns ValidationSummary — a flat, list-optimized shape with fewer fields than TransactionValidation).

transactionValidations · object[]

List of transaction validation records.

Show child attributes

hasMore · boolean

Whether there are more results available.

nextCursor · string | null

Cursor for fetching the next page. Null if no more results.