Pular para o conteúdo principal
GET
/
v1
/
validations
Listar Validações de Transações
curl --request GET \
  --url https://tracer.lerian.io/v1/validations \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <api-key>'
{ "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==" }

Documentation Index

Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt

Use this file to discover all available pages before exploring further.

Autorizações

​
X-API-Key
string
header
obrigatório

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

Cabeçalhos

​
Content-Type
string
obrigatório

O tipo de mídia do recurso. Deve ser application/json.

​
X-API-Key
string
obrigatório

A chave de API para autenticação. Este header é obrigatório para todos os endpoints, exceto verificações de integridade.

​
X-Request-Id
string<uuid>

Um identificador único usado para rastrear cada requisição.

Parâmetros de consulta

​
limit
integer
padrão:100

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

Intervalo obrigatório: 1 <= x <= 1000
​
cursor
string

Cursor de paginação da resposta anterior. Ao usar cursor, sortBy e sortOrder não podem ser alterados.

​
sort_by
enum<string>
padrão:created_at

O campo usado para ordenar os resultados.

Opções disponíveis:
created_at,
processing_time_ms
​
sort_order
enum<string>
padrão:DESC

A ordem usada para ordenar os resultados.

Opções disponíveis:
ASC,
DESC
​
start_date
string<date-time>

Filtrar a partir desta data (inclusivo). Deve estar no formato RFC3339 com fuso horário. O padrão é 90 dias antes do horário atual.

​
end_date
string<date-time>

Filtrar até esta data (exclusivo). Deve estar no formato RFC3339 com fuso horário. O padrão é o horário atual.

​
decision
enum<string>

Filtrar por decisão (ALLOW, DENY, REVIEW).

Opções disponíveis:
ALLOW,
DENY,
REVIEW
​
account_id
string<uuid>

Filtrar por ID da conta (UUID).

​
matched_rule_id
string<uuid>

Filtrar por ID da regra correspondente (UUID).

​
exceeded_limit_id
string<uuid>

Filtrar por ID do limite excedido (UUID).

​
segment_id
string<uuid>

Filtrar por ID do segmento (UUID).

​
portfolio_id
string<uuid>

Filtrar por ID do portfólio (UUID).

​
transaction_type
enum<string>

Filtrar por tipo de transação.

Opções disponíveis:
CARD,
WIRE,
PIX,
CRYPTO

Resposta

Indica que a requisição foi bem-sucedida e a resposta contém os dados esperados.

Lista paginada de validações de transações (retorna ValidationSummary — uma forma achatada e otimizada para listagem, com menos campos que TransactionValidation).

​
transactionValidations
object[]

Lista de registros de validação de transações.

​
hasMore
boolean

Se há mais resultados disponíveis.

​
nextCursor
string | null

Cursor para buscar a próxima página. Nulo se não houver mais resultados.