Skip to main content
GET
/
v1
/
validations
List Transaction Validations
curl --request GET \
  --url https://tracer.lerian.io/v1/validations \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <x-api-key>'
{
  "transactionValidations": [
    {
      "validationId": "aa0e8400-e29b-41d4-a716-446655440001",
      "accountId": "bb0e8400-e29b-41d4-a716-446655440002",
      "segmentId": "cc0e8400-e29b-41d4-a716-446655440003",
      "transactionType": "CARD",
      "amount": 150000,
      "currency": "BRL",
      "decision": "ALLOW",
      "reason": "Transaction approved",
      "matchedRuleIds": [],
      "exceededLimitIds": [],
      "processingTimeMs": 23,
      "createdAt": "2026-01-30T10:30:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "eyJpZCI6IjEyMzQifQ=="
}

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.

​
sortBy
enum<string>
default:createdAt

The field used to sort the results.

Available options:
createdAt,
processingTimeMs
​
sortOrder
enum<string>
default:DESC

The order used to sort the results.

Available options:
ASC,
DESC
​
startDate
string<date-time>

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

​
endDate
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
​
accountId
string<uuid>

Filter by account ID (UUID).

​
matchedRuleId
string<uuid>

Filter by matched rule ID (UUID).

​
exceededLimitId
string<uuid>

Filter by exceeded limit ID (UUID).

​
segmentId
string<uuid>

Filter by segment ID (UUID).

​
portfolioId
string<uuid>

Filter by portfolio ID (UUID).

​
transactionType
enum<string>

Filter by transaction type.

Available options:
CARD,
WIRE,
PIX,
CRYPTO

Response

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

Paginated list of transaction validations.

​
transactionValidations
object[]

List of transaction validation records.

​
hasMore
boolean

Whether there are more results available.

​
nextCursor
string | null

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